Requests

Pay

The Pay action is the default action for the Wero. With this action a new transaction will be initiated.

Pay request

Example pay request

{
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "Description": "test",
    "Invoice": "wero_purchase",
    "ReturnURL": "https://www.buckaroo.nl",
    "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
    "ReturnURLError": "https://www.buckaroo.nl/mislukt",
    "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
    "Services": {
        "ServiceList": [
            {
                "Name": "Wero",
                "Action": "Pay",
                "Parameters": [
                ]
            }
        ]
    }
}

Pay response

Example response

{
    "Key": "2555220BA4C14E11ABC85E5D956B8526",
    "Status": {
        "Code": {
            "Code": 791,
            "Description": "Pending processing"
        },
        "SubCode": {
            "Code": "S002",
            "Description": "An additional action is required: Redirect to Wero landing page"
        },
        "DateTime": "2025-09-19T10:29:01"
    },
    "RequiredAction": {
        "RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=3BE75F7528FE4498BF9ECE884A053F79",
        "RequestedInformation": null,
        "PayRemainderDetails": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "wero_purchase",
    "ServiceCode": "wero",
    "IsTest": true,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "TransactionType": "C124",
    "MutationType": 1,
    "RelatedTransactions": null,
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": null,
    "PayerHash": null,
    "PaymentKey": "4DC91D6EE38940638C81680D3A2309C1"
}

Pay push

Example push

{
  "Transaction": {
    "Key": "BC574DEE9B7848F3A4D464495C321450",
    "Invoice": "WeroPay_Mvzm6DKSPKZ",
    "ServiceCode": "wero",
    "Status": {
      "Code": {
        "Code": 190,
        "Description": "Success"
      },
      "SubCode": {
        "Code": "S990",
        "Description": "The request was successful."
      },
      "DateTime": "2025-09-18T13:17:34"
    },
    "IsTest": true,
    "Order": null,
    "Currency": "EUR",
    "AmountDebit": 0.99,
    "TransactionType": "C124",
    "Services": [
      {
        "Name": "wero",
        "Action": null,
        "Parameters": [
          {
            "Name": "consumerName",
            "Value": "Filan Fisteku"
          },
          {
            "Name": "consumerIBAN",
            "Value": "DE80111122340000091789"
          },
          {
            "Name": "paymentId",
            "Value": "0d232234-7039-4a6a-abba-0676a99c675b"
          }
        ],
        "VersionAsProperty": 1
      }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 1,
    "RelatedTransactions": null,
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "Filan Fisteku",
    "PayerHash": null,
    "PaymentKey": "91E58B64F79F4870832A8FD3CCFF7903",
    "Description": "Automationtest_Wero_Pay_1758194236"
  }
}

Authorize

Authorize request

Example authorize request

{
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "Description": "test",
    "Invoice": "wero_auth",
    "ReturnURL": "https://www.buckaroo.nl",
    "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
    "ReturnURLError": "https://www.buckaroo.nl/mislukt",
    "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
    "Services": {
        "ServiceList": [
            {
                "Name": "Wero",
                "Action": "Authorize",
                "Parameters": [
                ]
            }
        ]
    }
}

Authorize response

Example authorize response

{
    "Key": "BC239A701A5746FA88424E6020385574",
    "Status": {
        "Code": {
            "Code": 791,
            "Description": "Pending processing"
        },
        "SubCode": null,
        "DateTime": "2025-09-19T10:34:03"
    },
    "RequiredAction": {
        "RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=8B8D286ED90F464CB61D5613D83B0EBA",
        "RequestedInformation": null,
        "PayRemainderDetails": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "wero_auth",
    "ServiceCode": "wero",
    "IsTest": true,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "TransactionType": "I106",
    "MutationType": 3,
    "RelatedTransactions": null,
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": null,
    "PayerHash": null,
    "PaymentKey": null
}

Cancel authorize

Cancel authorize request

Example

{
  "Currency": "EUR",
  "AmountCredit": 0.01,
  "Description": "test",
  "Invoice": "wero_cancelAuth - j",
  "ReturnURL": "https://www.buckaroo.nl",
  "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
  "ReturnURLError": "https://www.buckaroo.nl/mislukt",
  "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
  "OriginalTransactionKey": "BC239A701A5746FA88424E6020385574", 
  "ClientIP": {
      "Type": 0,
      "Address": "0.0.0.0"
   },
  "Services": {
    "ServiceList": [
      {
        "Name": "Wero",
        "Action": "CancelAuthorize"
      }
    ]
  }
}

Cancel authorize response

Example

{
    "Key": "46BCA2AE2B004EC5867D7372F7A0EFEB",
    "Status": {
        "Code": {
            "Code": 190,
            "Description": "Success"
        },
        "SubCode": null,
        "DateTime": "2025-09-19T10:39:03"
    },
    "RequiredAction": null,
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "wero_cancelAuth - j",
    "ServiceCode": "wero",
    "IsTest": true,
    "Currency": "EUR",
    "AmountCredit": 0.01,
    "TransactionType": "I107",
    "MutationType": 3,
    "RelatedTransactions": null,
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "Filan Fisteku",
    "PayerHash": null,
    "PaymentKey": null
}

Cancel authorize push

Example

{
  "Transaction": {
    "Key": "46BCA2AE2B004EC5867D7372F7A0EFEB",
    "Invoice": "wero_cancelAuth - j",
    "ServiceCode": "wero",
    "Status": {
      "Code": {
        "Code": 190,
        "Description": "Success"
      },
      "SubCode": null,
      "DateTime": "2025-09-19T10:39:03"
    },
    "IsTest": true,
    "Order": null,
    "Currency": "EUR",
    "AmountCredit": 0.01,
    "TransactionType": "I107",
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 3,
    "RelatedTransactions": null,
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "Filan Fisteku",
    "PayerHash": null,
    "PaymentKey": null,
    "Description": "test"
  }
}

Capture

Capture request

Example

{
  "Currency": "EUR",
  "AmountDebit": 0.01,
  "Description": "test ",
  "Invoice": "wero_capture",
  "ReturnURL": "https://www.buckaroo.nl",
  "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
  "ReturnURLError": "https://www.buckaroo.nl/mislukt",
  "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
  "OriginalTransactionKey": "A03F36EC5EFC4386B8E53C15535A6425", 
  "ClientIP": {
      "Type": 0,
      "Address": "0.0.0.0"
   },
  "Services": {
    "ServiceList": [
      {
        "Name": "Wero",
        "Action": "Capture"
      }
    ]
  }
}

Capture response

Example

{
    "Key": "C50AEC39447442DBB91480925B17CFF3",
    "Status": {
        "Code": {
            "Code": 190,
            "Description": "Success"
        },
        "SubCode": {
            "Code": "S990",
            "Description": "The request was successful."
        },
        "DateTime": "2025-09-19T10:42:39"
    },
    "RequiredAction": null,
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "wero_capture",
    "ServiceCode": "wero",
    "IsTest": true,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "TransactionType": "C126",
    "MutationType": 1,
    "RelatedTransactions": null,
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "Filan Fisteku",
    "PayerHash": null,
    "PaymentKey": "050DD578BE124544B68037F7DF0DA711"
}

Capture push

Example

{
  "Transaction": {
    "Key": "C50AEC39447442DBB91480925B17CFF3",
    "Invoice": "wero_capture",
    "ServiceCode": "wero",
    "Status": {
      "Code": {
        "Code": 190,
        "Description": "Success"
      },
      "SubCode": {
        "Code": "S990",
        "Description": "The request was successful."
      },
      "DateTime": "2025-09-19T10:42:39"
    },
    "IsTest": true,
    "Order": null,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "TransactionType": "C126",
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 1,
    "RelatedTransactions": null,
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "Filan Fisteku",
    "PayerHash": null,
    "PaymentKey": "050DD578BE124544B68037F7DF0DA711",
    "Description": "test "
  }
}

Refund

Refund request

Example refund request

{
    "Currency": "EUR",
    "AmountCredit": 0.01,
    "Description": "something big :)",
    "Invoice": "wero_refund",
    "ReturnURL": "https://www.buckaroo.nl",
    "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
    "ReturnURLError": "https://www.buckaroo.nl/mislukt",
    "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
    "OriginalTransactionKey": "C50AEC39447442DBB91480925B17CFF3",
    "Services": {
        "ServiceList": [
            {
                "Name": "Wero",
                "Action": "Refund",
                "Parameters": []
            }
        ]
    }
}

Refund response

Example refund response

{
    "Key": "32AA73913121419BB0460A74353ECF6C",
    "Status": {
        "Code": {
            "Code": 190,
            "Description": "Success"
        },
        "SubCode": {
            "Code": "S990",
            "Description": "The request was successful."
        },
        "DateTime": "2025-09-19T10:44:53"
    },
    "RequiredAction": null,
    "Services": [
        {
            "Name": "wero",
            "Action": null,
            "Parameters": [
                {
                    "Name": "customeraccountname",
                    "Value": "Filan Fisteku"
                },
                {
                    "Name": "CustomerIBAN",
                    "Value": "DE80111122340000091789"
                },
                {
                    "Name": "Processed",
                    "Value": "Classic"
                }
            ]
        }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "wero_refund",
    "ServiceCode": "wero",
    "IsTest": true,
    "Currency": "EUR",
    "AmountCredit": 0.01,
    "TransactionType": "C127",
    "MutationType": 1,
    "RelatedTransactions": [
        {
            "RelationType": "refund",
            "RelatedTransactionKey": "C50AEC39447442DBB91480925B17CFF3"
        }
    ],
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "Filan Fisteku",
    "PayerHash": null,
    "PaymentKey": "8C38BA47836A4303A106581EBEAC851E"
}

Refund push

Example push

{
  "Transaction": {
    "Key": "32AA73913121419BB0460A74353ECF6C",
    "Invoice": "wero_refund",
    "ServiceCode": "wero",
    "Status": {
      "Code": {
        "Code": 190,
        "Description": "Success"
      },
      "SubCode": {
        "Code": "S990",
        "Description": "The request was successful."
      },
      "DateTime": "2025-09-19T10:44:53"
    },
    "IsTest": true,
    "Order": null,
    "Currency": "EUR",
    "AmountCredit": 0.01,
    "TransactionType": "C127",
    "Services": [
      {
        "Name": "wero",
        "Action": null,
        "Parameters": [
          {
            "Name": "customeraccountname",
            "Value": "Filan Fisteku"
          },
          {
            "Name": "CustomerIBAN",
            "Value": "DE80111122340000091789"
          },
          {
            "Name": "Processed",
            "Value": "Classic"
          }
        ],
        "VersionAsProperty": 1
      }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 1,
    "RelatedTransactions": [
      {
        "RelationType": "refund",
        "RelatedTransactionKey": "C50AEC39447442DBB91480925B17CFF3"
      }
    ],
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "Filan Fisteku",
    "PayerHash": null,
    "PaymentKey": "8C38BA47836A4303A106581EBEAC851E",
    "Description": "something big :)"
  }
}