Requests
Pay
The default action for Sofortbanking is Pay. This action has no input except the basic transaction details. Upon receiving this input, the consumer will be redirected to Sofortbanking site for verification and confirmation of the payment. After completion at the Sofortbanking site, the customer is redirected back to the merchant site.
Use the base request as instructed on this page
Pay request
Parameters
Example request
{
"Currency": "EUR",
"AmountDebit": 10,
"Invoice": "testinvoice 123",
"ClientIP": {
"Type": 0,
"Address": "0.0.0.0"
},
"Services": {
"ServiceList": [
{
"Name": "sofortueberweisung",
"Action": "Pay"
}
]
}
}
Pay response
Parameters
Example response
{
"Key": "F3FCCF41EBE243389838AD64718XXXXX",
"Status": {
"Code": {
"Code": 791,
"Description": "Pending processing"
},
"SubCode": {
"Code": "S002",
"Description": "An additional action is required: RedirectToSofort"
},
"DateTime": "2017-07-20T10:59:08"
},
"RequiredAction": {
"RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=8649FE9B96E641E281BE954E1ACXXXXX",
"RequestedInformation": null,
"PayRemainderDetails": null,
"Name": "Redirect",
"TypeDeprecated": 0
},
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "testinvoice 123",
"ServiceCode": "sofortueberweisung",
"IsTest": true,
"Currency": "EUR",
"AmountDebit": 10,
"TransactionType": "N074",
"MutationType": 1,
"RelatedTransactions": null,
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "F10431F7293D4147A436FB3B43DXXXXX"
}
Pay push
If the immediate succes option is enabled, a confirmed payment will return a succes status (190).
#### Parameters
#### Service specific parameters
Parameter | Type | Required | Recommended | Description |
---|---|---|---|---|
CustomerIBAN | String | N/A | N/A | IBAN bank account number of the customer. |
CustomerBIC | String | N/A | N/A | BIC code of the customers' bank. |
Example push
{
"Transaction": {
"Key": "F3FCCF41EBE243389838AD64718XXXXX",
"Invoice": "testinvoice 123",
"ServiceCode": "sofortueberweisung",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "P190",
"Description": "Payment has not yet arrived. A reversal is still possible. Refunding is not yet possible."
},
"DateTime": "2017-07-20T11:00:18+02:00"
},
"IsTest": true,
"Order": null,
"Currency": "EUR",
"AmountDebit": 10,
"TransactionType": "N074",
"Services": [
{
"Name": "sofortueberweisung",
"Action": null,
"Parameters": [
{
"Name": "CustomerIBAN",
"Value": "NL10SFRT00234XXXXX"
},
{
"Name": "CustomerBIC",
"Value": "SFRTNL20XXX"
}
],
"VersionAsProperty": 1
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": null,
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": "John Smith",
"PayerHash": null,
"PaymentKey": "F10431F7293D4147A436FB3B43DXXXXX"
}
}
Refund
To refund a successful Sofortbanking transaction, use the action Refund. A bank transfer is then initiated which transfers the amount of the original transaction back to the consumer. This is only possible once Buckaroo received the money from the original payment. This can take up to two working days after the initial succes confirmation of the original payment.
Refund request
Parameters
Service specific parameters
Parameter | Type | Required | Recommended | Description |
---|---|---|---|---|
OriginalTransactionKey | String | Yes | N/A | Transactionkey of the payment that needs to be refunded. |
Example request
{
"Currency": "EUR",
"AmountCredit": 1,
"Invoice": "testinvoice 123",
"OriginalTransactionKey": "F3FCCF41EBE243389838AD64718C497B",
"Services": {
"ServiceList": [
{
"Name": "sofortueberweisung",
"Action": "Refund"
}
]
}
}
Refund response
Parameters
Example request
{
"Key": "DCA29123BE8A4FBFB901886AA2DXXXXX",
"Status": {
"Code": {
"Code": 690,
"Description": "Rejected"
},
"SubCode": {
"Code": "S122",
"Description": "The transaction is non-refundable."
},
"DateTime": "2017-07-20T11:23:36"
},
"RequiredAction": null,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "testinvoice 123",
"ServiceCode": "sofortueberweisung",
"IsTest": true,
"Currency": "EUR",
"AmountCredit": 1,
"TransactionType": "C543",
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "F3FCCF41EBE243389838AD64718XXXXX"
}
],
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "1A303AEB9E46437E900524A9453XXXXX"
}
Refund push
Parameters
Example push
{
"Transaction": {
"Key": "DCA29123BE8A4FBFB901886AA2DXXXXX",
"Invoice": "testinvoice 123",
"ServiceCode": "sofortueberweisung",
"Status": {
"Code": {
"Code": 690,
"Description": "Afgewezen"
},
"SubCode": {
"Code": "S122",
"Description": "De transactie kan niet worden gerefund."
},
"DateTime": "2017-07-20T11:23:36+02:00"
},
"IsTest": true,
"Order": null,
"Currency": "EUR",
"AmountCredit": 1,
"TransactionType": "C543",
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "F3FCCF41EBE243389838AD6471XXXXX"
}
],
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "1A303AEB9E46437E900524A9453XXXXX"
}
}