880 – Dispute Notification

Notifies the merchant about disputes to transaction.

880 Notification Data description

NODE
INCLUDE IN CHECKSUM (IN THIS ORDER)
OPTIONAL
DATA TYPE
DESCRIPTION

apiUser

YES (1)

YES

Character max 50.

The API user assigned by the Gateway to the merchant. Can be obtained from the website inside your merchant account.

apiPassword

YES (2)

YES

Character max 50.

The API password assigned by Gateway to the merchant. Can be obtained from the website inside your merchant account.

apiCmd

YES (3)

YES

880

3 digit numeric transaction code must be 880

gatetransid

YES (4)

YES

Character max 50.

Unique gateway internal transaction id.

transref

YES

Character max 50.

Unique gateway internal transaction reference.

merchanttransid

YES

Character max 50.

Unique merchant transaction id received in the request.

status

Yes (5)

YES

Character

CHARGEBACK: transaction was reported as chargeback. FRAUD: transaction was reported as TC-40 Fraud ALERT: transaction was reported as a fraud by issuer through independent system COPYREQUEST: Issuing Bank requested some details about the transaction and proof of product delivery or service provide.

amount

YES

Character exactly 3

3-letter code of currency, example: USD, EUR

disputeDate

YES

YYYY-MM-DD HH:MM:SS

Date of the dispute

ARN

NO

Character max 256.

Acquirer reference number. Required for dispute procedure

reasonCode

COND

Character no limit

Code of chargeback’s reason

reasonText

COND

Character max 256.

Description of chargeback’s reason

merchantspecific1

YES

Character max 200.

Merchant specific data for merchant use only. Data sent is the same as was sent in the 700 transaction.

merchantspecific2

YES

Character max 200.

Merchant specific data for merchant use only. Data sent is the same as was sent in the 700 transaction.

merchantspecific3

YES

Character max 200.

Merchant specific data for merchant use only. Data sent is the same as was sent in the 700 transaction.

merchantspecific4

YES

Character max 200.

Merchant specific data for merchant use only. Data sent is the same as was sent in the 700 transaction.

merchantspecific5

YES

Character max 200.

Merchant specific data for merchant use only. Data sent is the same as was sent in the 700 transaction.

time

YES

Character 25.

Date and time of notification generation in ISO 8601 format, example: 2015-11-07T15:04:42+00:00

checksum

YES

Character 36

SHA-1 calculated using the fields specified by the transaction plus the API key assigned by GPN DATA to the merchant. This field must be calculated using the fields marked as “Include in checksum” plus the API key at the end.

880 Notification Sample

<?xmlversion="1.0" encoding="utf-8" ?>
<transaction>
		<apiUser> </apiUser>
		<apiPassword> </apiPassword>
		<apiCmd>880</apiCmd>
		<gatetransid> </gatetransid>
		<transref> </transref>
		<merchanttransid> </merchanttransid>
		<status> </status>
		<amount> </amount>
		<currency> </currency>
		<disputeDate> </disputeDate>
		<arn> </arn>
		<reasonCode> </reasonCode>
		<reasonText> </reasonText>
		<merchantspecific1> </merchantspecific1>
		<merchantspecific2> </merchantspecific2>
		<merchantspecific3> </merchantspecific3>
		<merchantspecific4> </merchantspecific4>
		<merchantspecific5> </merchantspecific5>
		<time> </time>
		<checksum> </checksum>		
</transaction> 

Last updated