Read a Smart Transaction
To check the status you need to read the Smart Transaction:
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:
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"
,
// ...
"payment_instructions"
: {
"owner"
:
"secupay AG"
,
"iban"
:
"DE81850400611005523759"
,
"bic"
:
"COBADEFFXXX"
,
"bankname"
:
"Commerzbank CC"
,
"purpose"
:
"TA 49425099"
,
"girocode_url"
:
"https://connect-testing.secupay-ag.de/qr/epc?stx=STX_33PXAW2YN2NJTPM5KPGMK7QF5PBVA2"
},
// ...
}
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.
The bank transfer details are per transaction. You are obliged to pass them to the customer. In the case of prepayment, this can be done with the order confirmation email and preferably also on the success page in the store. In the case of purchase on account, please continue to show the transfer details on the invoice. If not otherwise possible, please send a separate e-mail.
This is the status flow of a Smart Transaction for e-commerce orders (intent order):
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. |