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

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

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

 <?xmlversion="1.0" encoding="utf-8" ?>
<transaction>
		<apiUser> </apiUser>
		<apiPassword> </apiPassword>
		<apiCmd>850</apiCmd>
		<merchanttransid> </merchanttransid>
		<gatetransid> </gatetransid>
		<amount> </amount>
		<curcode> </curcode>
		<state> </state>
		<merchantspecific1> </merchantspecific1>
		<merchantspecific2> </merchantspecific2>
		<merchantspecific3> </merchantspecific3>
		<merchantspecific4> </merchantspecific4>
		<merchantspecific5> </merchantspecific5>
		<description> </description>
		<time> </time>
		<checksum> </checksum>		
</transaction>

Last updated