Did you find this summary helpful?
Thank you for your feedback
Pay The default action for Giropay is Pay. Upon receiving the input, the consumer will be redirected to Giropay page at his bank for verification and confirmation of the payment. After completion at the bank site, the customer is redirected back to the merchant site.
Base JSON request
Use the base request as instructed on this page
Parameters Service specific parameters Parameter Type Required Recommended Description bic string The international bankcode identifying the customer's bank. This information can be supplied, otherwise the customer has to select their at Giropay. CustomerIBAN string The customer's IBAN with which he/she wants to perform the Giropay transaction. If the customer tries to pay with a different IBAN, the transaction will be rejected by Giropay. This parameter can be used to prevent fraud: when a customer fills in IBAN B on your website and on the Giropay page tries to pay with IBAN A, they will not be able to pay. If they fill in IBAN A on your website which you know is not theirs, you can block them from starting a payment on your website. Please note that blocking the payment on your website is something you have to implement yourself.
Pay request Example request {
"Currency": "EUR",
"AmountDebit": 10.00,
"Invoice": "testinvoice 123",
"Services": {
"ServiceList": [
{
"Name": "giropay",
"Action": "Pay",
"Parameters": [
{
"Name": "bic",
"Value": "GENODETT488"
},
{
"Name": "CustomerIBAN",
"Value": "NL13TEST0123456789"
}
]
}
]
}
}
Pay response Parameters Service specific parameters Parameter Type Required Recommended Description consumerBIC string The international bankcode identifying the customer's bank.
Example response: {
"Key": "6473D552EB7F4074817A9A6F1BFBxxxx",
"Status": {
"Code": {
"Code": 791,
"Description": "Pending processing"
},
"SubCode": {
"Code": "S002",
"Description": "An additional action is required: Verify at Giropay"
},
"DateTime": "2018-04-16T16:05:28"
},
"RequiredAction": {
"RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=D71F06AB0C9540FC8C76BF7FA76xxxx",
"RequestedInformation": null,
"PayRemainderDetails": null,
"Name": "Redirect",
"TypeDeprecated": 0
},
"Services": [
{
"Name": "giropay",
"Action": null,
"Parameters": [
{
"Name": "consumerBIC",
"Value": "GENODETT488"
}
]
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "testinvoice 123",
"ServiceCode": "giropay",
"IsTest": true,
"Currency": "EUR",
"AmountDebit": 10.00,
"TransactionType": "C241",
"MutationType": 1,
"RelatedTransactions": null,
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "397BB56968074AE7AC99EFC8A264xxxx"
}
Pay push When the consumer has completed the payment, the transaction status will be pushed with a succes status.
Parameters Service specific parameters Parameter Type Required Recommended Description consumerBIC string The international bankcode identifying the customer's bank. consumerBankleitzahl string The national bank code of the customer's account, which is part of their IBAN.
Example push: {
"Transaction": {
"Key": "8A69B71E57244B71866104A0D636xxxx",
"Invoice": "testinvoice 123",
"ServiceCode": "giropay",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S001",
"Description": "Transaction successfully processed"
},
"DateTime": "2018-04-16T16:04:16"
},
"IsTest": true,
"Order": null,
"Currency": "EUR",
"AmountDebit": 10,
"TransactionType": "C241",
"Services": [
{
"Name": "giropay",
"Action": null,
"Parameters": [
{
"Name": "consumerBIC",
"Value": "GENODETT488"
},
{
"Name": "consumerBankleitzahl",
"Value": "44448888"
},
{
"Name": "consumerIBAN",
"Value": "NL13TEST0123456789"
}
],
"VersionAsProperty": 2
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": null,
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "C5D95257D04343E2BC34576D309Exxxx"
}
}
Refund To refund a successful Giropay transaction, use the action Refund. A bank transfer is then initiated which transfers the amount of the original transaction back to the consumer.
Refund request Parameters Service specific parameters Parameter Type Required Recommended Description OriginalTransactionKey string Yes Transaction key of the original transaction that needs to be refunded. Please note: this is a basic parameter.
Example request: {
"Currency": "EUR",
"AmountCredit": 1,
"Invoice": "testinvoice 123",
"OriginalTransactionKey": "30D459B07FD648A993ACF7D4DXXXXXX",
"Services": {
"ServiceList": [
{
"Name": "giropay",
"Action": "Refund"
}
]
}
}
Refund response Parameters Service specific parameters Parameter Type Required Recommended Description customeraccountname string The customer's accountname at the bank to which the refund was performed. CustomerIBAN string The customer's IBAN to which the refund was performed. CustomerBIC string The international bankcode, identifying the customer's bank, belonging to the IBAN to which the refund was performed.
Example response: {
"Key": "BE6434EE6C8440B882A2A90C0XXXXX",
"Status": {
"Code": {
"Code": 690,
"Description": "Rejected"
},
"SubCode": {
"Code": "S122",
"Description": "The transaction is non-refundable."
},
"DateTime": "2017-07-20T10:21:57"
},
"RequiredAction": null,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "testinvoice 123",
"ServiceCode": "giropay",
"IsTest": true,
"Currency": "EUR",
"AmountCredit": 1,
"TransactionType": "C242",
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "30D459B07FD648A993ACF7D4D0BXXXXX"
}
],
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "499003EB3FFC4B49B65F639C5EXXXXX"
}
Refund push Parameters Service specific parameters Parameter Type Required Recommended Description customeraccountname string The customer's accountname at the bank to which the refund was performed. CustomerIBAN string The customer's IBAN to which the refund was performed. CustomerBIC string The international bankcode, identifying the customer's bank, belonging to the IBAN to which the refund was performed.
Example push: {
"Transaction": {
"Key": "BE6434EE6C8440B882A2A90C0F2XXXXX",
"Invoice": "testinvoice 123",
"ServiceCode": "giropay",
"Status": {
"Code": {
"Code": 690,
"Description": "Afgewezen"
},
"SubCode": {
"Code": "S122",
"Description": "De transactie kan niet worden gerefund."
},
"DateTime": "2017-07-20T10:21:57+02:00"
},
"IsTest": true,
"Order": null,
"Currency": "EUR",
"AmountCredit": 1,
"TransactionType": "C242",
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "30D459B07FD648A993ACF7D4D0XXXXX"
}
],
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "499003EB3FFC4B49B65F639C5EXXXXXX"
}
}
Thank you for your feedback! Our team will get back to you