Step 3: Make the Payment

Note: The demo flag (is_demo) has no effect on terminal payments. Please use small amounts of one or a few Euro Cents.

You can make a card payment calling POST /api/v2/Smart/Transactions/{id}/start/cashless:

Request

POST /api/v2/Smart/Transactions/STX_3HXQQBSVK2XWNAX7ESCZH9NZY3YZAZ/start/cashless HTTP/1.1
Host: connect-testing.secupay-ag.de
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:

Response

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.