This service can be used by the POS Partner (Merchant) to initiate a Completion/Capture via an online channel.
COMPATIBILITY
Type | Compatibility |
---|---|
Card present (CP) | No |
Card not present (CNP) | Yes |
REQUEST
Type | Endpoint |
---|---|
POST | /payment/v1/interface/pos/completion |
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 calling partner code This code will allow to retreive transactions in the payment provider extranet |
Y | Fols | |
PosCode | String | Name of 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 This amount must not be greater than the one of preauthorization |
|
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 |
- 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 Format “XXX” |
|
Y |
EUR |
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 if payment is OK |
|
Y |
|
MerchantTicket |
String (1000) |
Merchant receipt 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 |
Device out |
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" } |