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”

Pay

This action initiates the Point of Sale transactions

View in playground

Request


JSON gateway request

TerminalID
Required

The unique terminal ID. This can be found on the back of the terminal

JSON

copy
{
  "Currency": "EUR",
  "AmountDebit": 0.01,
  "Invoice": "TestFactuur01",
  "Services": {
    "ServiceList": [
      {
        "Name": "pospayment",
        "Action": "Pay",
        "Parameters": [
          {
            "Name": "TerminalID",
            "Value": "50000001"
          }
        ]
      }
    ]
  }
}

Response


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

copy
{
  "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

Details about the transaction destined for the consumer

JSON

copy
{ 
   "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"
   }
}