You can make a card payment calling POST /api/v2/Smart/Transactions/{id}/start/cashless
:
POST /api/v2/Smart/Transactions/STX_3HXQQBSVK2XWNAX7ESCZH9NZY3YZAZ/start/cashless HTTP/1.1
Host: connect-testing.secuconnect.com
Authenticate: Bearer qb56tjj1bcvo9n2nj4u38k84lo
Accept: application/json
Now the payment terminal waits for the customer to authorise the payment.
This request is blocking. Secuconnect API only responds after the authorisation process has been finished or was aborted.
If everything is fine, the API responds with 200 OK
and the representation of the Smart Transaction:
HTTP/1.1 200 OK
Content-Type: application/json
...
{
"object"
:
"smart.transactions"
,
"id"
:
"STX_3HXQQBSVK2XWNAX7ESCZH9NZY3YZAZ"
,
// ...
"device_source"
: {
"object"
:
"smart.devices"
,
"id"
:
"SDV_2T23JN7KS2NVMPJ76SPZV9HGWXFHA2"
},
"device_destination"
: {
"object"
:
"smart.devices"
,
"id"
:
"SDV_N3C58PPZA2NUXX67A0ST289A6JEYA2"
},
"transactions"
: [],
"created"
:
"2021-02-25T08:47:25+01:00"
,
"updated"
:
"2021-02-25T08:48:11+01:00"
,
"status"
:
"ok"
,
// ...
"receipt"
: [
{
"type"
:
"separator"
,
"value"
: {
"caption"
:
"Kartenzahlung"
}
},
{
"type"
:
"textline"
,
"value"
: {
"text"
:
"* * Kundenbeleg * *"
,
"decoration"
: []
}
},
// ...
{
"type"
:
"name-value"
,
"value"
: {
"name"
:
"Terminal-ID"
,
"value"
:
"72015255"
,
"decoration"
: []
}
},
{
"type"
:
"space"
},
{
"type"
:
"name-value"
,
"value"
: {
"name"
:
"Betrag EUR"
,
"value"
:
"0,01"
,
"decoration"
: []
}
},
{
"type"
:
"space"
},
{
"type"
:
"textline"
,
"value"
: {
"text"
:
"Karte akzeptiert"
,
"decoration"
: [
"align-center"
,
"important"
]
}
}
],
"receipt_merchant"
: [
{
"type"
:
"separator"
,
"value"
: {
"caption"
:
"Kartenzahlung"
}
},
{
"type"
:
"textline"
,
"value"
: {
"text"
:
"* * Händlerbeleg * *"
,
"decoration"
: []
}
},
// ...
{
"type"
:
"textline"
,
"value"
: {
"text"
:
"Unterschrift umseitig"
,
"decoration"
: []
}
}
],
"receipt_merchant_print"
:
true
,
"basket_info"
: {
"sum"
: 1,
"gratuity"
:
null
,
"currency"
:
"EUR"
},
"payment_method"
:
"cashless"
,
"receipt_number"
: 3,
// ...
}
The status ok
and the receipts for the customer (receipt
) and the merchant (receipt
) signalise, that the payment was successful.
The receipts must be printed by the electronic cash register. The merchant must preserve the receipt to show it on demand. In some cases the customer must sign the merchant receipt.
The Reference part has examples with unshortened receipt representation, and a section dedicated to printing the receipt.