# 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) | 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      | 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

```xml
 <?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>
```