This service can be used by the POS Partner (Merchant) to Cancel a Preauthorization via an online channel.
COMPATIBILITY
| Type | Compatibility |
|---|---|
| Card present (CP) | No |
| Card not present (CNP) | Yes |
REQUEST
| Type | Endpoint |
|---|---|
| POST | /payment/v1/interface/pos/cancel |
PARAMETERS
|
Name |
Type |
Description |
CP mandatory |
CNP mandatory |
Example |
|
ServerName |
string |
Name of the calling server |
|
Y |
S-RF-H9732-FS1 |
|
WorkStationName |
String |
Name of the calling station |
|
Y |
L-5G01TH4 |
|
MerchantCode |
String |
Name of the calling origin (Merchant code) |
|
Y |
0449 |
| PartnerCode | String |
Name of the calling partner This code will allow to retreive transactions in the payment provider extranet |
Y | Fols | |
| PosCode | String | Name of the calling point of sale (Hotel, Restaurant, Bar, Spa…) | Y | H | |
|
Token |
string |
Card token which allow Accor to know if client is present or not. |
|
Y |
8766778345690119 |
|
ExpirationDate |
string |
Card expiration date Format="YYMM" |
|
Y |
2206 |
|
Amount |
String |
Transaction amount |
|
Y |
120.00 |
|
Currency |
String (200) |
Transaction currency |
|
Y |
EUR |
|
Device |
Integer |
Type of device |
|
Y |
CNP : 0 |
|
TransactionId |
String (50) |
Transaction reference regarding the previous preauthorization transaction. |
|
Y |
84547193121
|
RESPONSE
|
Name |
Type |
Description |
CP mandatory |
CNP mandatory |
Example |
|
responseCode |
String |
Response code depending on transaction status: - 0 : if response OK - 99 : if response KO for CNP message |
|
Y |
99 |
|
responseMessage |
String |
- 0 : OPERATION_OK - 99 : DeviceOut
Note: this response message can contain the description of the error. |
|
Y |
99 |
|
responseIdentifier |
String |
Should be "null" |
|
N |
Null |
|
responseObject |
String |
response object (see details below) |
|
Y |
|
|
nextPollingTime |
String |
Should be "null" |
|
N |
Null |
Detail of the object "responseObject"
|
Name |
Type |
Description |
CP mandatory |
CNP mandatory |
Example |
|
Token |
string |
Card token which allow Accor to know if client is present or not. |
|
Y |
8766778345690119 |
|
ExpirationDate |
string |
Card expiration date Format: “YYMM” |
|
Y |
2006 |
|
Amount |
String |
Transaction amount |
|
Y |
120.00 |
|
Currency |
String (200) |
Transaction currency |
|
Y |
EUR Format “XXX” |
|
CardType |
String (200) |
Card type : VI, CA, AX Other card : JC, DC, CU, PF, BC, RU a mapping could be done depending partner |
|
Y |
VI |
|
ClientTicket |
String (1000) |
Customer receipt data if payment is OK |
|
Y |
|
|
MerchantTicket |
String (1000) |
Merchant receipt data if payment is OK |
|
Y |
|
|
ApprovalCode |
String (8) |
Acquirer approval code for the transaction |
|
Y |
041016 |
|
TransactionId |
String (50) |
Identifier reference for the transaction. The value should be the same as the one present in the Preauthorization response. |
|
Y |
84547193121
|
|
ResponseCode |
String |
- 0 : if response OK - 99 : if response KO for CNP message |
|
Y |
99 |
|
ResponseMessage |
String |
- 0 : OPERATION_OK - 99 : DeviceOut
Note: this response message can contain the description of the error. |
|
Y |
99 |
EXAMPLE 1
This example show request/response for a card not present transaction.
Example of request :
|
{ "Token":"8766778345690119", "ExpirationDate":"2212", "Amount":"80.00", "Currency":"EUR", "Device":"0", "TransactionId": "84547193121", "ServerName":"S-RF-H9732-F1", "WorkStationName":"L-5C046FG", "MerchantCode":"9732", "PartnerCode":"FOLS", "PosCode":"H" } |
Example of response OK :
|
{ "responseCode": "0", "responseMessage": "OPERATION_OK", "responseIdentifier": "null", "responseObject": { "responseCode": "0", "responseMessage": "OPERATION_OK", "currency": "EUR", "cardType": "5", "clientTicket": "APOL MERCURE VALENCIENNES CENTRE Musterstr. 01 Musterstadt 90111 GERMANY -------------------------------- 24.09.20 17:16 KUNDENBELEG -------------------------------- TERMINAL: 54055584 HÃNDLER: 147777778 PAN: XXXXXXXXXXXX0119 KARTENTYP: Visa MANUELLES STORNO MANUELLER EINTRAG BETRAG: 190,00 EUR REFERENZ: 770233171212 GENEHMIGUNGS-NR.: SM5845 (00) AUTORISIERUNG ERFOLGT KEINE KARTENINH. VERIFIZIERUNG BITTE FUR IHRE UNTERLAG. AUFBEW.", "merchantTicket": "APOL MERCURE VALENCIENNES CENTRE Musterstr. 01 Musterstadt 90111 GERMANY -------------------------------- 24.09.20 17:16 HÃNDLERBELEG -------------------------------- TERMINAL: 54055584 HÃNDLER: 147777778 PAN: XXXXXXXXXXXX0119 KARTENTYP: Visa MANUELLES STORNO MANUELLER EINTRAG BETRAG: 190,00 EUR REFERENZ: 770233171212 GENEHMIGUNGS-NR.: SM5845 (00) AUTORISIERUNG ERFOLGT KEINE KARTENINH. VERIFIZIERUNG BITTE FUR IHRE UNTERLAG. AUFBEW.", "approvalCode": "041016", "token": "8766778345690119", "expirationDate": "2212", "amount": "80.00", "transactionId": "84547193121" }, "nextPollingTime": "null" } |
Example of response KO :
|
{ "responseCode": "99", "responseMessage": "NotFound", "responseIdentifier": "null", "responseObject": "null", "nextPollingTime": "null" } |