Pay with Prepayment
Prerequisites
As a prerequisite, you should understand:
Make the Payment
The API endpoint to make an advance payment is POST /Smart/Transactions/STX_xxx/start/prepaid. There is no prior authorisation needed.
POST /api/v2/Smart/Transactions/STX_xxx/start/prepaid 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 Smart Transaction:
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"
,
"status"
:
"pending"
,
// ...
"payment_method"
:
"prepaid"
,
"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"
},
"trans_id"
: 49425099,
// ...
}
The Smart Transaction will change to status pending to signalise that we still wait for the payment. When the payment has arrived, it switches to ok (intent sale), and you can deliver.
Response parameters:
Field |
Type |
Meaning |
transactions |
array |
The Payment Transactions and Loyalty Transactions created for this Smart Transaction. |
status |
string |
Status ok means you can deliver. Status pending means you have to wait for ok. Status failed means the payment failed, and you must repeat the payment process. |
payment_instructions |
object |
The payment instructions to be given to the payer. |
Details of payment_instructions:
Field |
Type |
Meaning |
owner |
string |
Account owner |
iban |
string |
International Bank Account Number (IBAN) |
bic |
string |
Bank Identifier Code (BIC) |
bankname |
string |
Bank name |
purpose |
string |
Purpose line |
girocode_url |
string |
Image URL of an Girocode (EPC QR code) for the banking app. |
See Also
Further information:
Other payment methods: