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 orders (intent order):

images/inline/b2392a009a30df0457c9860632c71a24d3b73561.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, received or collection.

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

received

The payment capture was approved and you can ship the goods.

This is used in conjunction with orders for shipping.

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

shipped

You have shipped the goods.

collection

The payment capture was approved and you can prepare the goods for collection, or alternatively ship them.

This is used in conjunction with orders for collection.

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

collected

The goods have been collected by your customer.

failed

Failed to authorise or actually capture the payment.