Payment Retry (EasyCard)
This API implement is necessary.
If the Retry value is 1 or more than 1 (Error code: 000125 or 0462xx) in the response data during transactions, please call Retry API
When some processes are not completed or are interrupted (eg. Cards are removed from the reader during payment process), the translations will not be completed and will lead some errors. Please follow the process below to complete the transaction:
Check the reason of transaction failure, for example, re-place the card on the reader.
Transaction retry will be made 3 times, if it is still failed at the 3rd time (Retry=3), the transaction will not be completed and the retry will no longer be available. Please report this transaction to EasyCard Company.
Request
Header
Item | Mandatory | Data Type | Sample | Description |
Method | YES | String(5) | 31800 | Fill in 31800 (EasyCard transaction) |
ServiceType | YES | String | Payment | Enter the Response>Header>ServiceType of the erroneous transaction |
MchId | YES | String | Account0001 | Enter the Response>Header>MchID of the erroneous transaction |
TradeKey | YES | String | sha256...hash | Marchant password provided by intella, this password must be encoded by SHA256 |
CreateTime | YES | String | 20180101120000 | Request time, the format is "yyyyMMddHHmmss" |
Data
Item | Mandatory | Data Type | Sample | Description |
Retry | YES | String | 1 | Enter the Response>Data>Retry of the erroneous transaction |
DeviceId | YES | String | 01301234 | Enter the Response>Data>Request>DeviceID of the erroneous transaction |
Amount | YES | String | 50 | Enter the Response>Data>request>Amount of the erroneous transaction |
StoreOrderNo | YES | String | PO12345678 | Enter the Response>Data>OrderId of the erroneous transaction |
TerminalTXNNumber | YES | String | 091212 | Enter the Response>Data>request>TerminalTXNNumber of the erroneous transaction |
HostSerialNumber | YES | String | 091212 | Enter the Response>Data>request>HostSerialNumber of the erroneous transaction |
RefundKey | (YES) | String | sha256...hash | Refund password. If the ServiceType is Refund/Cancel/EZCRefund, this field will be required |
ActionType | (YES) | String | If the ServiceType is Cancel, it can be obtained from the Response of erroneous transaction |
Response
Header
Item | Mandatory | Data Type | Sample | Description |
StatusCode | YES | String | 0000 | |
StatusDesc | YES | String | STATUS_SUCCESS | Description of transaction status |
Method | YES | String | 31800 | Payment method code (EasyCard payment is 31800) |
ServiceType | YES | String | Payment | Selected Scan2Pay Service type, same as the ServiceType in Resquest |
MchId | YES | String | Account0001 | Merchant ID |
ResponseTime | YES | String | 20180101120000 | Transaction response time, the format is "yyyyMMddHHmmss" |
Data
Item | Mandatory | Data Type | Sample | Description |
request | YES | JSON String | Data in request | |
TXNResult | YES | String | Success | Transaction result |
Retry | YES | String | 0 | The Retry value of next request |
ErrorCode | YES | String | 000000 | |
OrderId | YES | String | PO12345678 | Order number |
NewAESKey | NO | String | For internal use |
The fields in Data are different depend on the transaction result and type. Please refer to the Response code of each function (eg. Payment/Refund)
API Example
Transaction retry error (payment)
Request
Response
1st time retry (Failed)
Request
Response
2nd time retry (Success)
Request
Response
Last updated