General
Point of Sale transaction are PIN transaction done through separate PIN terminals. This is used for in-store transactions. In the request the merchants includes the unique terminal ID. Buckaroo will then send the transaction to the PIN terminal. Once the transaction is completed, all transaction information is included in the push message. This can then be printed on the customer receipt.
Servicecodes and actions
Point of Sales uses the following servicecode: pospayment
The following actions are included: Pay
Channel
All Point of Sales transactions need to be done using the channel “Web”
Request
JSON gateway request
|
TerminalID
string
|
Required
The unique terminal ID. This can be found on the back of the terminal |
JSON
{
"Currency": "EUR",
"AmountDebit": 0.01,
"Invoice": "TestFactuur01",
"Services": {
"ServiceList": [
{
"Name": "pospayment",
"Action": "Pay",
"Parameters": [
{
"Name": "TerminalID",
"Value": "50000001"
}
]
}
]
}
}
Response 200 Status: Ok 400 Status: Access denied 500 Status: Bad request
JSON gateway response
If the request has a valid structure and a valid signature, a transaction will be created in the Payment Engine and a response will be returned. In this case, a pending status is returned. This means that the transaction has not yet been completed at the terminal. The response does not contain service specific variables.
JSON
{
"Key": "A5417E98043647D095B857E16Cxxxxxx",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S001",
"Description": "Transaction successfully processed"
},
"DateTime": "2020-02-18T09:17:12"
},
"RequiredAction": null,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "TestFactuur01",
"ServiceCode": "pospayment",
"IsTest": true,
"Currency": "EUR",
"AmountDebit": 0.01,
"TransactionType": "V735",
"MutationType": 2,
"RelatedTransactions": null,
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "31ACA5F1CFCB404A94014952AExxxxxx"
}
Push
JSON push response
|
Ticket
string
|
Details about the transaction destined for the consumer |
JSON
{
"Transaction":{
"Key":"8D2EAFC8F76D40FEBA204AFB53Fxxxxx",
"Invoice":"TestFactuur01",
"ServiceCode":"pospayment",
"Status":{
"Code":{
"Code":190,
"Description":"Success"
},
"SubCode":{
"Code":"S001",
"Description":"Transaction successfully processed"
},
"DateTime":"2020-02-18T15:00:11"
},
"IsTest":false,
"Order":null,
"Currency":"EUR",
"AmountDebit":0.01,
"TransactionType":"V735",
"Services":[
{
"Name":"PosPayment",
"Action":null,
"Parameters":[
{
"Name":"Ticket",
"Value":"[0]\r\n[0]POI: 50000001\r\n[0]KLANTTICKET\r\n[0]------------------------------------------------\r\n[0]Terminal: 5000001 Merchant: 20000001\r\n[0]Periode: 1299 Transactie: 00000001\r\n[0]\r\n[1] Maestro \r\n[0]\r\n[0] (A0000000000001) \r\n[0]\r\n[0]Kaart: xxxxxxxxxxxxxxx5005 \r\n[0]\r\n[0]Kaartserienummer: 8\r\n[0]\r\n[0]BETALING \r\n[0]Datum: 18/02/2020 15:00 \r\n[0]\r\n[0]Autorisatiecode: xxxxxx \r\n[0]\r\n[0]REF: 2F9AFBE6695B4FCBAC32C373BxxxxxxC\r\n[0]\r\n[0]WORLDLINE. \r\n[0]\r\n[1]Totaal: 0,01 EUR\r\n[0]\r\n[0]Contactless\r\n[0]\r\n[0]Leesmethode: CHIP\r\n[0]\r\n[1] DANK U \r\n[1] TOT ZIENS \r\n"
}
]
}
],
"CustomParameters":null,
"AdditionalParameters":null,
"MutationType":2,
"RelatedTransactions":null,
"IsCancelable":false,
"IssuingCountry":null,
"StartRecurrent":false,
"Recurring":false,
"CustomerName":null,
"PayerHash":null,
"PaymentKey":"2F9AFBE6695B4FCBAC32C373B6Cxxxxx"
}
}