850 – Transaction state Notification
Notifies the merchant about the result of a submitted charge as well as most other commands except for Credits (720), Refunds (760), Rebills (756) and received chargebacks, frauds, alerts and other di
To modify the transaction status on your end, utilize the 'state' field value to correspond with the transaction status. Any additional information, such as the status code, can be included as extra data.
850 Notification Data 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
850
3 digit numeric transaction code must be 850
merchanttransid
YES (4)
YES
Character max 50.
Unique merchant transaction id received in the charge request.
gatetransid
Unique gateway internal transaction id.
amount
Yes (5)
YES
Number with point decimal
Full amount to charge in specified currency. Decimal separator must be point (.). example: 125.45 = One hundred and twenty-five Major Currency Units with forty-five Minor Currency Units.
curcode
YES (6)
YES
Character exactly 3
3-letters Currency Code. Must be one of approved in the Merchant Profile.
state
YES
Character
Current state of the transaction. AUTHORIZED: Funds from Customers Credit Card account have been “reserved” but not charged to the account. CAPTURED: Customer’s Credit Card account has been charged with the amount of the transaction. DECLINED: transaction was declined. PENDING: Transaction is in pending state CANCELED: authorization of the transaction was canceled CREDITED: Customer’s Credit Card was credited with the amount of the transaction ERROR: An error occurred during transaction processing REVERSED: Transaction was reversed REFUNDED: Transaction was refunded REFUND PENDING: Refund is waiting for staff confirmation CHARGEBACK: means that a chargeback for the transaction was received by the gateway.
merchantspecific1
YES
Character max 200.
Merchant specific data for merchant use only. Data sent in this field will be stored and sent in any communication or response to the merchant.
merchantspecific2
YES
Character max 200.
Merchant specific data for merchant use only. Data sent in this field will be stored and sent in any communication or response to the merchant.
merchantspecific3
YES
Character max 200.
Merchant specific data for merchant use only. Data sent in this field will be stored and sent in any communication or response to the merchant.
merchantspecific4
YES
Character max 200.
Merchant specific data for merchant use only. Data sent in this field will be stored and sent in any communication or response to the merchant.
merchantspecific5
YES
Character max 200.
Merchant specific data for merchant use only. Data sent in this field will be stored and sent in any communication or response to the merchant.
description
NO
Character max 100.
Additional descriptive information about this transaction status.
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.
850 Notification Sample
Last updated