Read a Smart Transaction

To check the status you need to read the Smart Transaction:

Request
GET /api/v2/Smart/Transactions/STX_33PXAW2YN2NJTPM5KPGMK7QF5PBVA2 HTTP/1.1
Host: connect-testing.secupay-ag.de
Authorization: Bearer qb56tjj1bcvo9n2nj4u38k84lo
Accept: application/json

If everything is fine, the API responds with 200 OK: and the object representation:

Response
HTTP/1.1 200 OK
Content-Type: application/json
...
  
{
    "object": "smart.transactions",
    "id": "STX_33PXAW2YN2NJTPM5KPGMK7QF5PBVA2",
    // ...
    "transactions": [
        {
            "object": "payment.transactions",
            "id": "PCI_FDBREW9ZS7P6FTN4ZY2ATC6NK0QWO7"
        }
    ],
    "created": "2020-03-27T10:55:23+01:00",
    "updated": "2020-03-27T10:56:41+01:00",
    "status": "ok",
    // ...
}

The status of the Smart Transaction will be ok (intent sale), received (intent order and shipping), or collection (intent order and collection). If you have to wait for the payment before you deliver, the status is pending. This can happen with advance payment (prepaid) and occassionally with SEPA direct debit.

This is the status flow of a Smart Transaction for e-commerce payments (intent sale):

images/inline/f7359a5c3b0f07d1fc269d490de841bb872e7246.png

Some of the statusses will be skipped if they are not needed.

Detailed explanation:

Status

Description

created

Newly created Smart Transaction, modified before the payment was actually captured.

approved

The payment is pre-authorised. It should be possible to capture the payment.

Skipped if auto_capture is true.

pending

The payment capture was requested, but is not acknowledged yet. You need to wait for status ok.

Always used with advance payment (prepaid). Can also occur with direct debiting (debit).

ok

The payment capture was approved and you can deliver.

Note: Please don't forget to mark delivery in conjuction with invoice payment (invoice). Otherwise we cannot be aware of the due date.

failed

Failed to authorise or actually capture the payment.