Requests

All requests use the service name In3 with the Route parameter set to AbnB2b.

Authorize

Use Authorize to start a Zakelijk op Rekening transaction with the intention to capture it later. This call initiates the credit check of the business customer. If the check is approved, the response contains a redirect URL where the customer completes the order.

Amount limits
Zakelijk op Rekening can be used for orders from EUR 250 to EUR 25,000. An authorization outside this range is rejected.

Business customers only
Zakelijk op Rekening supports business to business orders only. The Category of the billing customer must be B2B, and the company details of the buyer must be supplied.

Parameters

Route

Parameter	Type	GroupType	GroupID	Value	Required	Description
Route	string			AbnB2b	Mandatory	Route of the transaction. Use `AbnB2b` for Zakelijk op Rekening

Article

Parameter	Type	GroupType	GroupID	Value	Required	Description
Identifier	string	Article	1	ABC123	Optional	Way to identify the article
Type	string	Article	1	Physical	Optional	Type of the article
Description	string	Article	1	Blue Toy Car	Mandatory	Description of the article
Category	string	Article	1	Toy Car	Optional	Category of the article
Quantity	integer	Article	1	1	Mandatory	Quantity of the article
GrossUnitPrice	decimal	Article	1	5000	Mandatory	Gross unit price of the article
QuantityDescription	string	Article	1	Pieces	Optional	Quantity description of the article
VatPercentage	numeric	Article	1	21	Optional	VAT percentage of the article
VatAmount	decimal	Article	1	0.01	Optional	VAT amount of the article
DeliveryDate	date	Article	1	YYYY-MM-DD	Optional	Delivery date of the article

BillingCustomer

Parameter	Type	GroupType	GroupID	Value	Required	Description
CustomerNumber	string	BillingCustomer	1	123456	Mandatory	Customer number of the billing customer
Category	string	BillingCustomer	1	B2B	Mandatory	Category of the billing customer. Always `B2B`, because the method does not support consumer orders
CompanyName	string	BillingCustomer	1	Buckaroo B.V.	Mandatory	Company name of the billing customer
CocNumber	string	BillingCustomer	1	12345678	Mandatory	Chamber of Commerce number of the billing customer
FirstName	string	BillingCustomer	1	John	Optional	First name of the contact person
LastName	string	BillingCustomer	1	Doe	Mandatory	Last name of the contact person
Initials	string	BillingCustomer	1	JD	Optional	Initials of the contact person
BirthDate	date	BillingCustomer	1	YYYY-MM-DD	Optional	Birth date of the contact person
Phone	string	BillingCustomer	1	0612345678	Mandatory	Phone number of the billing customer
Email	string	BillingCustomer	1	[email protected]	Mandatory	E-mail address of the billing customer
CareOf	string	BillingCustomer	1	John Doe	Optional	Care of the billing customer
Street	string	BillingCustomer	1	Zonnebaan	Mandatory	Street of the billing customer
StreetNumber	string	BillingCustomer	1	9	Mandatory	Street number of the billing customer
StreetNumberSuffix	string	BillingCustomer	1	A	Optional	Street number suffix of the billing customer
PostalCode	string	BillingCustomer	1	3542EA	Mandatory	Postal code of the billing customer
City	string	BillingCustomer	1	Utrecht	Mandatory	City of the billing customer
Region	string	BillingCustomer	1	Utrecht	Optional	Region of the billing customer
CountryCode	string	BillingCustomer	1	NL	Mandatory	Country code of the billing customer

ShippingCustomer

Parameter	Type	GroupType	GroupID	Value	Required	Description
CareOf	string	ShippingCustomer	1	Jane Doe	Optional	Care of the shipping customer
Street	string	ShippingCustomer	1	Zonnebaan	Mandatory	Street of the shipping customer
StreetNumber	string	ShippingCustomer	1	9	Mandatory	Street number of the shipping customer
StreetNumberSuffix	string	ShippingCustomer	1	A	Optional	Street number suffix of the shipping customer
PostalCode	string	ShippingCustomer	1	3542EA	Mandatory	Postal code of the shipping customer
City	string	ShippingCustomer	1	Utrecht	Mandatory	City of the shipping customer
Region	string	ShippingCustomer	1	Utrecht	Optional	Region of the shipping customer
CountryCode	string	ShippingCustomer	1	NL	Mandatory	Country code of the shipping customer

Invoice

Parameter	Type	GroupType	GroupID	Value	Required	Description
InvoiceDate	date			YYYY-MM-DD	Optional	Invoice date
InvoiceUrl	string			https://www.buckaroo.nl	Optional	URL of the invoice

Example request

{
  "Currency": "EUR",
  "AmountDebit": 5000.0,
  "AmountCredit": null,
  "Invoice": "ZOR Authorize 1693216267",
  "Order": null,
  "Description": "Zakelijk op Rekening authorize",
  "ClientIP": null,
  "ReturnURL": null,
  "ReturnURLCancel": null,
  "ReturnURLError": null,
  "ReturnURLReject": null,
  "OriginalTransactionKey": null,
  "ServicesSelectableByClient": null,
  "ServicesExcludedForClient": null,
  "PushURL": null,
  "PushURLFailure": null,
  "ClientUserAgent": null,
  "OriginalTransactionReference": null,
  "Services": {
    "ServiceList": [
      {
        "Name": "In3",
        "Action": "Authorize",
        "Version": 0,
        "Parameters": [
          { "Name": "Route", "Value": "AbnB2b" },
          { "Name": "Identifier", "GroupType": "Article", "GroupID": "1", "Value": "ABC123" },
          { "Name": "Type", "GroupType": "Article", "GroupID": "1", "Value": "Physical" },
          { "Name": "Description", "GroupType": "Article", "GroupID": "1", "Value": "Blue Toy Car" },
          { "Name": "Category", "GroupType": "Article", "GroupID": "1", "Value": "Toy Car" },
          { "Name": "Quantity", "GroupType": "Article", "GroupID": "1", "Value": "1" },
          { "Name": "GrossUnitPrice", "GroupType": "Article", "GroupID": "1", "Value": "5000" },
          { "Name": "QuantityDescription", "GroupType": "Article", "GroupID": "1", "Value": "Pieces" },
          { "Name": "VatPercentage", "GroupType": "Article", "GroupID": "1", "Value": "21" },
          { "Name": "VatAmount", "GroupType": "Article", "GroupID": "1", "Value": "0.01" },
          { "Name": "DeliveryDate", "GroupType": "Article", "GroupID": "1", "Value": "2026-11-11" },
          { "Name": "CustomerNumber", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "123456" },
          { "Name": "Category", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "B2B" },
          { "Name": "CompanyName", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "Buckaroo B.V." },
          { "Name": "CocNumber", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "12345678" },
          { "Name": "FirstName", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "John" },
          { "Name": "LastName", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "Doe" },
          { "Name": "Initials", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "JD" },
          { "Name": "Phone", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "0612345678" },
          { "Name": "Email", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "[email protected]" },
          { "Name": "CareOf", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "John Doe" },
          { "Name": "Street", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "Zonnebaan" },
          { "Name": "StreetNumber", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "9" },
          { "Name": "StreetNumberSuffix", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "A" },
          { "Name": "PostalCode", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "3542EA" },
          { "Name": "City", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "Utrecht" },
          { "Name": "Region", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "Utrecht" },
          { "Name": "CountryCode", "GroupType": "BillingCustomer", "GroupID": "1", "Value": "NL" },
          { "Name": "CareOf", "GroupType": "ShippingCustomer", "GroupID": "1", "Value": "Jane Doe" },
          { "Name": "Street", "GroupType": "ShippingCustomer", "GroupID": "1", "Value": "Zonnebaan" },
          { "Name": "StreetNumber", "GroupType": "ShippingCustomer", "GroupID": "1", "Value": "9" },
          { "Name": "StreetNumberSuffix", "GroupType": "ShippingCustomer", "GroupID": "1", "Value": "A" },
          { "Name": "PostalCode", "GroupType": "ShippingCustomer", "GroupID": "1", "Value": "3542EA" },
          { "Name": "City", "GroupType": "ShippingCustomer", "GroupID": "1", "Value": "Utrecht" },
          { "Name": "Region", "GroupType": "ShippingCustomer", "GroupID": "1", "Value": "Utrecht" },
          { "Name": "CountryCode", "GroupType": "ShippingCustomer", "GroupID": "1", "Value": "NL" },
          { "Name": "InvoiceDate", "GroupType": "", "GroupID": "", "Value": "2026-12-01" },
          { "Name": "InvoiceUrl", "GroupType": "", "GroupID": "", "Value": "https://www.buckaroo.nl" }
        ]
      }
    ]
  },
  "CustomParameters": null,
  "AdditionalParameters": null
}

Example response

The response contains the redirect URL where the customer completes the order.

{
  "Key": "9A2C1AEC43F64EAA820970**********",
  "Status": {
    "Code": {
      "Code": 791,
      "Description": "Pending processing"
    },
    "SubCode": {
      "Code": "S002",
      "Description": "An additional action is required: Redirect"
    },
    "DateTime": "2026-03-23T08:12:04"
  },
  "RequiredAction": {
    "RedirectURL": "https://checkout.buckaroo.nl/html/redirect.ashx?r=A85BFD4B91BC48189C588***********",
    "RequestedInformation": null,
    "PayRemainderDetails": null,
    "Name": "Redirect",
    "TypeDeprecated": 0
  },
  "Services": null,
  "CustomParameters": null,
  "AdditionalParameters": null,
  "RequestErrors": null,
  "Invoice": "ZOR Authorize 1693216267",
  "ServiceCode": "In3",
  "Currency": "EUR",
  "AmountDebit": 5000.0,
  "TransactionType": "I027",
  "MutationType": 1,
  "RelatedTransactions": null,
  "ConsumerMessage": null,
  "Order": null,
  "IssuingCountry": null,
  "StartRecurrent": false,
  "Recurring": false,
  "CustomerName": null,
  "PayerHash": null,
  "PaymentKey": "03AB82E49A834D2CB06B98**********"
}

Example push

{
  "Transaction": {
    "Key": "9A2C1AEC43F64EAA820970**********",
    "Invoice": "ZOR Authorize 1693216267",
    "ServiceCode": "In3",
    "Status": {
      "Code": {
        "Code": 190,
        "Description": "Success"
      },
      "SubCode": {
        "Code": "S990",
        "Description": "The request was successful."
      },
      "DateTime": "2026-03-23T08:12:31"
    },
    "Order": null,
    "Currency": "EUR",
    "AmountDebit": 5000.0,
    "TransactionType": "I027",
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 1,
    "RelatedTransactions": null,
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": null,
    "PayerHash": null,
    "PaymentKey": "03AB82E49A834D2CB06B98**********",
    "Description": "Zakelijk op Rekening authorize"
  }
}

Capture

Use Capture to finalise the transaction after a successful authorization. Reference the authorization through the OriginalTransactionKey. The capture is the moment ABN AMRO creates and sends the invoice to the buyer.

📘
Invoice lines
Invoice lines are optional when the capture amount equals the authorized amount. In that case Buckaroo reuses the article lines from the Authorize request. When the capture amount is lower than the authorized amount, invoice lines are mandatory.

Parameters

Parameter	Type	GroupType	GroupID	Value	Required	Description
Identifier	string	InvoiceLine	1	ABC123	Optional*	Identifier of the invoice line
Type	string	InvoiceLine	1	Physical	Optional*	Type of the invoice line
Description	string	InvoiceLine	1	Blue Toy Car	Optional*	Description of the invoice line
Category	string	InvoiceLine	1	Toy Car	Optional*	Category of the invoice line
Quantity	integer	InvoiceLine	1	1	Optional*	Quantity of the invoice line
GrossUnitPrice	decimal	InvoiceLine	1	5000	Optional*	Gross unit price of the invoice line
QuantityDescription	string	InvoiceLine	1	Pieces	Optional*	Quantity description of the invoice line
VatPercentage	numeric	InvoiceLine	1	21	Optional*	VAT percentage of the invoice line
VatAmount	decimal	InvoiceLine	1	0.01	Optional*	VAT amount of the invoice line
DeliveryDate	date	InvoiceLine	1	YYYY-MM-DD	Optional*	Delivery date of the invoice line

*Mandatory when the AmountDebit of the capture is lower than the authorized amount.

Example request

{
  "Currency": "EUR",
  "AmountDebit": 303,
  "AmountCredit": null,
  "Invoice": "ZOR Capture 1693216267",
  "Order": null,
  "Description": "Zakelijk op Rekening capture",
  "ClientIP": null,
  "ReturnURL": null,
  "ReturnURLCancel": null,
  "ReturnURLError": null,
  "ReturnURLReject": null,
  "OriginalTransactionKey": "6A7F029AA09A4E31904565B484872E04",
  "ServicesSelectableByClient": null,
  "ServicesExcludedForClient": null,
  "PushURL": null,
  "PushURLFailure": null,
  "ClientUserAgent": null,
  "OriginalTransactionReference": null,
  "Services": {
    "ServiceList": [
      {
        "Name": "In3",
        "Action": "Capture",
        "Version": 0,
        "Parameters": [
          { "Name": "Identifier", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "ABC123" },
          { "Name": "Type", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "Physical" },
          { "Name": "Description", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "Blue Toy Car" },
          { "Name": "Category", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "Toy Car" },
          { "Name": "Quantity", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "1" },
          { "Name": "GrossUnitPrice", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "303" },
          { "Name": "QuantityDescription", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "Pieces" },
          { "Name": "VatPercentage", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "21" },
          { "Name": "VatAmount", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "0.01" },
          { "Name": "DeliveryDate", "GroupType": "InvoiceLine", "GroupID": "1", "Value": "2026-11-11" }
        ]
      }
    ]
  },
  "CustomParameters": null,
  "AdditionalParameters": null
}

Example response

{
  "Key": "535574FEEA194A14A35C9BDF2A5FF194",
  "Status": {
    "Code": {
      "Code": 190,
      "Description": "Success"
    },
    "SubCode": {
      "Code": "S990",
      "Description": "The request was successful."
    },
    "DateTime": "2026-03-23T08:14:16"
  },
  "RequiredAction": null,
  "Services": null,
  "CustomParameters": null,
  "AdditionalParameters": null,
  "RequestErrors": null,
  "Invoice": "ZOR Capture 1693216267",
  "ServiceCode": "In3",
  "IsTest": false,
  "Currency": "EUR",
  "AmountDebit": 303.0,
  "TransactionType": "C063",
  "MutationType": 1,
  "RelatedTransactions": null,
  "ConsumerMessage": null,
  "Order": null,
  "IssuingCountry": null,
  "StartRecurrent": false,
  "Recurring": false,
  "CustomerName": null,
  "PayerHash": null,
  "PaymentKey": "FABFDD61C9A046209C5B6EEE932A2368"
}

Refund

Use Refund to refund a captured transaction, in full or in part. Provide the AmountCredit and the OriginalTransactionKey of the captured transaction.

Example request

{
  "Currency": "EUR",
  "AmountDebit": null,
  "AmountCredit": 303.0,
  "Invoice": "ZOR Refund 1693216289",
  "Order": null,
  "Description": "Zakelijk op Rekening refund",
  "ClientIP": null,
  "ReturnURL": null,
  "ReturnURLCancel": null,
  "ReturnURLError": null,
  "ReturnURLReject": null,
  "OriginalTransactionKey": "535574FEEA194A14A35C9BDF2A5FF194",
  "ServicesSelectableByClient": null,
  "ServicesExcludedForClient": null,
  "PushURL": null,
  "PushURLFailure": null,
  "ClientUserAgent": null,
  "OriginalTransactionReference": null,
  "Services": {
    "ServiceList": [
      {
        "Name": "In3",
        "Action": "Refund",
        "Version": 0,
        "Parameters": []
      }
    ]
  },
  "CustomParameters": null,
  "AdditionalParameters": null
}

Example response

{
  "Key": "0AA2B55B366A48D690D762**********",
  "Status": {
    "Code": {
      "Code": 190,
      "Description": "Success"
    },
    "SubCode": {
      "Code": "S990",
      "Description": "The request was successful."
    },
    "DateTime": "2026-03-23T08:20:11"
  },
  "RequiredAction": null,
  "Services": null,
  "CustomParameters": null,
  "AdditionalParameters": null,
  "RequestErrors": null,
  "Invoice": "ZOR Refund 1693216289",
  "ServiceCode": "In3",
  "Currency": "EUR",
  "AmountCredit": 303.0,
  "TransactionType": "C203",
  "MutationType": 1,
  "RelatedTransactions": [
    {
      "RelationType": "refund",
      "RelatedTransactionKey": "535574FEEA194A14A35C9BDF2A5FF194"
    }
  ],
  "ConsumerMessage": null,
  "Order": null,
  "IssuingCountry": null,
  "StartRecurrent": false,
  "Recurring": false,
  "CustomerName": null,
  "PayerHash": null,
  "PaymentKey": "40CB985149BE46BF9A67D5**********"
}

Transaction types

Transaction types reference
I027 Authorize · C063 Capture · C203 Refund