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.secuconnect.com
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.
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.
See Also
Further information:
Other payment methods: