Documentation
  • Welcome!
  • Card (server to server)
    • Overview
      • Authentication
      • Process Flow
      • API Endpoints
      • Testing
    • API Commands
      • 700 – Start Credit Card charge (3DS Enabled)
      • 701 – Request Capture Authorization
      • 702 – Request Cancel Authorization
      • 708 – Check transaction details
      • 709 – Check transaction status
      • 720 – Credit Request
      • 756 – Manual Rebill Request
      • 760 – Request Refund
    • Notifications
      • Notifications
      • 850 – Transaction state Notification
      • 860 – Refund Notification
      • 880 – Dispute Notification
    • Transaction Status Codes
    • 3D Secure Integration
  • APM Checkout (Blik)
    • Overview
      • Process Flow
      • Testing
    • Errors
      • Error object
      • Errors type list
      • Decline errors code list
    • Create a checkout session
    • Retrieve a Checkout Session
    • Webhoook Event Notification
    • Pay a Checkout Session
  • Refund a Checkout Session
  • Retrieve checkout session refund
  • Wallet API
    • Introduction
      • Authentication
      • Metadata
    • Errors
      • Error object
      • Errors type list
      • Decline errors code list
    • Payout
      • Create a payout
      • Retrieve a payout
  • Wallet payment page
    • Payment Page
Powered by GitBook
On this page
  • 880 Notification Data description
  • 880 Notification Sample
  1. Card (server to server)
  2. Notifications

880 – Dispute Notification

Notifies the merchant about disputes to transaction.

880 Notification Data description

NODE
INCLUDE IN CHECKSUM (IN THIS ORDER)
REQUIRED
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> 
Previous860 – Refund NotificationNextTransaction Status Codes

Last updated 10 days ago