Requests

      Requests


        Article Summary

        Pay

        Performing this action results in a credit check of the customer with Afterpay. If succesful, an order will be created at Afterpay and they will sent an invoice to the customer for payment completion (which will be handled by Afterpay). Buckaroo only registers the transaction to confirm the order.

        Base JSON request

        Use the base request as instructed on this page

        Pay request

        Parameters

        Service specific parameters

        ParameterTypeRequiredDescription
        ClientIPstringYesThis is a basic parameter. IP address of the customer.
        InvoicestringYesThis is a basic parameter. Invoice/order number. May only contain alphanumeric characters, dashes and underscores. Max 19 characters.
        DescriptionstringYesGroupType: Article. Article name/description.
        GrossUnitPricedecimalYesGroupType: Article. Article price including VAT.
        VatPercentagedecimalYesGroupType: Article. VAT percentage on the article price.
        QuantitystringYesGroupType: Article. Article quantity.
        IdentifierstringYesGroupType: Article. Article number/code.
        ImageUrlstringGroupType: Article. URL for the image of this article. It will be turned into a thumbnail and displayed to the customer in MyAfterPay, on the invoice line next to the order item. The linked image must be a rectangle or square, width between 100 pixels and 1280 pixels.
        UrlstringGroupType: Article. URL to the article page.
        TypestringGroupType: Article. Article type. Possible values: PhysicalArticle, DigitalArticle, Giftcard, Discount, ShippingFee, Surcharge, Info, ShippingFees.
        UnitCodestringGroupType: Article. Unit in which the article is measured, such as pieces, liters, kilograms, etc.
        MarketPlaceSellerIdstringGroupType: Article Only applicable if used in combination with the service Marketplaces. Buckaroo merchant ID of the seller account for the article. Mandatory for each article. Each Seller ID should also be included in the Marketplace service request.
        CategorystringYesGroupType: BillingCustomer. Customer category of billing customer. Possible values: Person, Company.
        CompanyNamestringGroupType: BillingCustomer. Company name. Mandatory for B2B
        SalutationstringGroupType: BillingCustomer. Required if Billing country is NL or BE. Gender of billing customer. Possible values: Mr, Mrs, Miss.
        FirstNamestringYesGroupType: BillingCustomer. First name of billing customer.
        LastNamestringYesGroupType: BillingCustomer. Last name of billing customer, prefix included.
        BirthDatestringYesGroupType: BillingCustomer. Birth date of billing customer. Accepted formats: dd-mm-yyyy and yyyy-mm-dd.
        StreetstringYesGroupType: BillingCustomer. Street of billing customer.
        StreetNumberstringYesGroupType: BillingCustomer. House number of billing customer.
        StreetNumberAdditionalstringGroupType: BillingCustomer. House number suffix of billing customer.
        PostalCodestringYesGroupType: BillingCustomer. Postal code of billing customer.
        CitystringYesGroupType: BillingCustomer. City of billing customer.
        CountrystringYesGroupType: BillingCustomer. Country of billing customer. Possible values: NL, BE, DE, AT, FI.
        MobilePhonestringSee description*GroupType: BillingCustomer. **If Billing country is NL or BE, at least one phone number is required: either MobilePhone or Phone (landline).
        PhonestringSee description*GroupType: BillingCustomer. *If Billing country is NL or BE, at least one phone number is required: either MobilePhone or Phone (landline).
        EmailstringYesGroupType: BillingCustomer. Email address of billing customer.
        CareOfstringGroupType: BillingCustomer. Name of intermediary who is responsible for transferring a piece of mail between the postal system and the final addressee. For example Jane c/o John (“Jane at John's address”). This field has to be used for company, authority and organization names as well - e. g. "Sportverein Blau-Weiß e.V.
        ConversationLanguagestringGroupType: BillingCustomer. Conversation language of billing customer. Possible values: NL, FR, DE, FI.
        IdentificationNumberstringSee description*GroupType: BillingCustomer. *Required if Billing Country is Finland (FI). The customer’s national ID number, or the company’s registration number, depending on Category (Person or Company). Do not confuse with CustomerNumber.
        CustomerNumberstringGroupType: BillingCustomer. The number you assign to the billing customer.
        CategorystringSee description*GroupType: ShippingCustomer. *Required if ShippingCustomer information is provided. Customer category of shipping customer. Possible values: Person, Company.
        CompanyNamestringGroupType: ShippingCustomer. Company name. Mandatory for B2B
        SalutationstringSee description*GroupType: ShippingCustomer. *Required if ShippingCustomer information is provided ánd shipping country is NL or BE. Gender of shipping customer. Possible values: Mr, Mrs, Miss.
        FirstNamestringSee description*GroupType: ShippingCustomer. *Required if ShippingCustomer information is provided. First name of shipping customer.
        LastNamestringSee description*GroupType: ShippingCustomer. *Required if ShippingCustomer information is provided. Street of shipping customer.
        BirthDatestringGroupType: ShippingCustomer. Birth date of shipping customer. Accepted formats: dd-mm-yyyy and yyyy-mm-dd.
        StreetstringSee description*GroupType: ShippingCustomer. *Required if ShippingCustomer information is provided. Street of shipping customer.
        StreetNumberstringYesGroupType: ShippingCustomer. *Required if ShippingCustomer information is provided. House number of shipping customer.
        StreetNumberAdditionalstringGroupType: ShippingCustomer. House number suffix of shipping customer.
        PostalCodestringSee description*GroupType: ShippingCustomer. *Required if ShippingCustomer information is provided. Postal code of shipping customer.
        CitystringSee description*GroupType: ShippingCustomer. *Required if ShippingCustomer information is provided. City of shipping customer.
        CountrystringSee description*GroupType: ShippingCustomer. *Required if ShippingCustomer information is provided. Country of shipping customer. Possible values: Possible values: NL, BE, DE, AT, FI. If the value differs from the billing country, the request will be rejected by Afterpay.
        AddressTypestringGroupType: ShippingCustomer. Type of shipping address. Possible values: Standard, ShipTo, PickupPoint, InStore
        MobilePhonestringGroupType: ShippingCustomer. Mobile phone of shipping customer.
        PhonestringGroupType: ShippingCustomer. Phone number (landline) of shipping customer.
        EmailstringGroupType: ShippingCustomer. Email address of shipping customer.
        CareOfstringGroupType: ShippingCustomer. Name of intermediary who is responsible for transferring a piece of mail between the postal system and the final addressee. For example Jane c/o John (“Jane at John's address”). This field has to be used for company, authority and organization names as well - e. g. "Sportverein Blau-Weiß e.V.
        ConversationLanguagestringGroupType: ShippingCustomer. Conversation language of shipping customer. Possible values: NL, FR, DE, FI.
        IdentificationNumberstringGroupType: ShippingCustomer. The customer’s national ID number, or the company’s registration number, depending on Category (Person or Company). Do not confuse with CustomerNumber.
        CustomerNumberstringGroupType: ShippingCustomer. The number you assign to the shipping customer.
        MerchantImageUrlstringImage URL for the merchants brand. This image is shown at the top of the customer's order page in MyAfterPay.
        SummaryImageUrlstringCurrently does not do anything, but in the future, this might be used by AfterPay to show an image to the customer for the entire order. You can decide to send this in so that if/when AfterPay implements this, you will automatically use this feature.
        BankAccountstringThe customer's IBAN. Only required when the customer has to be invoiced through a SEPA Direct Debit and is only available for Dutch, German and Austrian consumers (BillingCustomerCountry NL, DE and AT).
        BankCodestringThe customer’s BIC. Can be used in conjunction with BankAccount, but not mandatory. Only available for Dutch, German and Austrian consumers (BillingCustomerCountry NL, DE and AT).
        YourReferencestringCan be used by purchasing company if they would like to provide internal reference
        OurReferencestringCan be used by selling company if they would like to provide specific reference for purchasing company
        Basic parameters

        Example request

        {
           "Currency": "EUR",
           "AmountDebit": 10,
           "Invoice": "testinvoice12345cv",
           "ClientIP": {
              "Type": 0,
              "Address": "0.0.0.0"
           },
           "Services": {
              "ServiceList": [
                 {
                    "Name": "afterpay",
                    "Action": "Pay",
                    "Parameters": [
                       {
                          "Name": "Description",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Blue Toy Car"
                       },
                       {
                          "Name": "GrossUnitPrice",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "10.00"
                       },
                       {
                          "Name": "VatPercentage",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "21"
                       },
                       {
                          "Name": "Quantity",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "1"
                       },
                       {
                          "Name": "Identifier",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Articlenumber12345"
                       },
                       {
                          "Name": "ImageUrl",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       },
                       {
                          "Name": "Url",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/"
                       },
                       {
                          "Name": "Type",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "PhysicalArticle"
                       },
                       {
                          "Name": "UnitCode",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Pieces"
                       },
                       {
                          "Name": "Category",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Person"
                       },
                       {
                          "Name": "Salutation",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Mr"
                       },
                       {
                          "Name": "FirstName",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Test"
                       },
                       {
                          "Name": "LastName",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Acceptatie"
                       },
                       {
                          "Name": "BirthDate",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "01-01-1990"
                       },
                       {
                          "Name": "Street",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Hoofdstraat"
                       },
                       {
                          "Name": "StreetNumber",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "90"
                       },
                       {
                          "Name": "StreetNumberAdditional",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "A"
                       },
                       {
                          "Name": "PostalCode",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "8441EE"
                       },
                       {
                          "Name": "City",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Heerenveen"
                       },
                       {
                          "Name": "Country",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "NL"
                       },
                       {
                          "Name": "MobilePhone",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "0698765433"
                       },
                       {
                          "Name": "Phone",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "0109876543"
                       },
                       {
                          "Name": "Email",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "billingcustomer@buckaroo.nl"
                       },
                       {
                          "Name": "CareOf",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "John Smith"
                       },
                       {
                          "Name": "ConversationLanguage",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "NL"
                       },
                       {
                          "Name": "IdentificationNumber",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "IdNumber12345"
                       },
                       {
                          "Name": "CustomerNumber",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "CustomerNumber12345"
                       },
                       {
                          "Name": "Category",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Person"
                       },
                       {
                          "Name": "Salutation",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Miss"
                       },
                       {
                          "Name": "FirstName",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Test"
                       },
                       {
                          "Name": "LastName",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Aflever"
                       },
                       {
                          "Name": "BirthDate",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "02-02-1980"
                       },
                       {
                          "Name": "Street",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Afleverstraat"
                       },
                       {
                          "Name": "StreetNumber",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "80"
                       },
                       {
                          "Name": "StreetNumberAdditional",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "B"
                       },
                       {
                          "Name": "PostalCode",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "7881ER"
                       },
                       {
                          "Name": "City",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Leeuwarden"
                       },
                       {
                          "Name": "AddressType",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Standard"
                       },
                       {
                          "Name": "Country",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "NL"
                       },
                       {
                          "Name": "MobilePhone",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "0698765432"
                       },
                       {
                          "Name": "Phone",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "0209876543"
                       },
                       {
                          "Name": "Email",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "shippingcustomer@buckaroo.nl"
                       },
                       {
                          "Name": "CareOf",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Martha Smith"
                       },
                       {
                          "Name": "ConversationLanguage",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "NL"
                       },
                       {
                          "Name": "IdentificationNumber",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "IdNumber12346"
                       },
                       {
                          "Name": "CustomerNumber",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "CustomerNumber12346"
                       },
                       {
                          "Name": "BankAccount",
                          "GroupType": "",
                          "GroupID": "",
                          "Value": "NL13TEST0123456789"
                       },
                       {
                          "Name": "BankCode",
                          "GroupType": "",
                          "GroupID": "",
                          "Value": "TESTNL2A"
                       },
                       {
                          "Name": "MerchantImageUrl",
                          "GroupType": "",
                          "GroupID": "",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       },
                       {
                          "Name": "SummaryImageUrl",
                          "GroupType": "",
                          "GroupID": "",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       }
                    ]
                 }
              ]
           }
        }
        

        Pay response

        JSON Gateway response

        Note: If a request is rejected (statuscode 690), then the reason is provided in Status->Subcode->Description and can be used to inform the customer.

        Parameters

        Basic parameters

        Example response:

        {
           "Key": "9A0F6A513A774A64AAC791C184F3XXXX",
           "Status": {
              "Code": {
                 "Code": 190,
                 "Description": "Success"
              },
              "SubCode": {
                 "Code": "S990",
                 "Description": "The request was successful."
              },
              "DateTime": "2019-03-13T11:56:35"
           },
           "RequiredAction": null,
           "Services": null,
           "CustomParameters": null,
           "AdditionalParameters": null,
           "RequestErrors": null,
           "Invoice": "testinvoice12345cv",
           "ServiceCode": "afterpay",
           "IsTest": true,
           "Currency": "EUR",
           "AmountDebit": 10,
           "TransactionType": "C039",
           "MutationType": 1,
           "RelatedTransactions": null,
           "ConsumerMessage": null,
           "Order": null,
           "IssuingCountry": null,
           "StartRecurrent": false,
           "Recurring": false,
           "CustomerName": "Test Acceptatie",
           "PayerHash": null,
           "PaymentKey": "5931B473CF88479F9D8611231F79XXXX"
        }
        

        Pay push

        Parameters

        Basic parameters

        Example push

        {
           "Transaction": {
              "Key": "9A0F6A513A774A64AAC791C184F3XXXX",
              "Invoice": "testinvoice12345cv",
              "ServiceCode": "afterpay",
              "Status": {
                 "Code": {
                    "Code": 190,
                    "Description": "Success"
                 },
                 "SubCode": {
                    "Code": "S990",
                    "Description": "The request was successful."
                 },
                 "DateTime": "2019-03-13T11:56:35"
              },
              "IsTest": true,
              "Order": null,
              "Currency": "EUR",
              "AmountDebit": 10,
              "TransactionType": "C039",
              "Services": null,
              "CustomParameters": null,
              "AdditionalParameters": null,
              "MutationType": 1,
              "RelatedTransactions": null,
              "IsCancelable": false,
              "IssuingCountry": null,
              "StartRecurrent": false,
              "Recurring": false,
              "CustomerName": "Test Acceptatie",
              "PayerHash": null,
              "PaymentKey": "5931B473CF88479F9D8611231F79XXXX"
           }
        }
        

        Authorize

        Performing an Authorize action results in a credit check of the customer with Afterpay. If succesful, an order will be placed, but no invoice will be sent to the customer yet. Perform a Capture request to initiate the latter.

        Authorize request

        An Authorize request is the same as a Pay request. The only difference is the action name.

        Basic parameters

        Example request

        {
           "Currency": "EUR",
           "AmountDebit": 10,
           "Invoice": "testinvoice12345cvc",
           "ClientIP": {
              "Type": 0,
              "Address": "0.0.0.0"
           },
           "Services": {
              "ServiceList": [
                 {
                    "Name": "afterpay",
                    "Action": "Authorize",
                    "Parameters": [
                       {
                          "Name": "Description",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Blue Toy Car"
                       },
                       {
                          "Name": "GrossUnitPrice",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "10.00"
                       },
                       {
                          "Name": "VatPercentage",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "21"
                       },
                       {
                          "Name": "Quantity",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "1"
                       },
                       {
                          "Name": "Identifier",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Articlenumber12345"
                       },
                       {
                          "Name": "ImageUrl",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       },
                       {
                          "Name": "Url",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/"
                       },
                       {
                          "Name": "Type",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "PhysicalArticle"
                       },
                       {
                          "Name": "UnitCode",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Pieces"
                       },
                       {
                          "Name": "Category",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Person"
                       },
                       {
                          "Name": "Salutation",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Mr"
                       },
                       {
                          "Name": "FirstName",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Test"
                       },
                       {
                          "Name": "LastName",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Acceptatie"
                       },
                       {
                          "Name": "BirthDate",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "01-01-1990"
                       },
                       {
                          "Name": "Street",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Hoofdstraat"
                       },
                       {
                          "Name": "StreetNumber",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "90"
                       },
                       {
                          "Name": "StreetNumberAdditional",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "A"
                       },
                       {
                          "Name": "PostalCode",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "8441EE"
                       },
                       {
                          "Name": "City",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "Heerenveen"
                       },
                       {
                          "Name": "Country",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "NL"
                       },
                       {
                          "Name": "MobilePhone",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "0698765433"
                       },
                       {
                          "Name": "Phone",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "0109876543"
                       },
                       {
                          "Name": "Email",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "billingcustomer@buckaroo.nl"
                       },
                       {
                          "Name": "CareOf",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "John Smith"
                       },
                       {
                          "Name": "ConversationLanguage",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "NL"
                       },
                       {
                          "Name": "IdentificationNumber",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "IdNumber12345"
                       },
                       {
                          "Name": "CustomerNumber",
                          "GroupType": "BillingCustomer",
                          "GroupID": "",
                          "Value": "CustomerNumber12345"
                       },
                       {
                          "Name": "Category",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Person"
                       },
                       {
                          "Name": "Salutation",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Miss"
                       },
                       {
                          "Name": "FirstName",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Test"
                       },
                       {
                          "Name": "LastName",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Aflever"
                       },
                       {
                          "Name": "BirthDate",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "02-02-1980"
                       },
                       {
                          "Name": "Street",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Afleverstraat"
                       },
                       {
                          "Name": "StreetNumber",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "80"
                       },
                       {
                          "Name": "StreetNumberAdditional",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "B"
                       },
                       {
                          "Name": "PostalCode",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "7881ER"
                       },
                       {
                          "Name": "City",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Leeuwarden"
                       },
                       {
                          "Name": "Country",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "NL"
                       },
                       {
                          "Name": "AddressType",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Standard"
                       },
                       {
                          "Name": "MobilePhone",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "0698765432"
                       },
                       {
                          "Name": "Phone",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "0209876543"
                       },
                       {
                          "Name": "Email",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "shippingcustomer@buckaroo.nl"
                       },
                       {
                          "Name": "CareOf",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "Martha Smith"
                       },
                       {
                          "Name": "ConversationLanguage",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "NL"
                       },
                       {
                          "Name": "IdentificationNumber",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "IdNumber12346"
                       },
                       {
                          "Name": "CustomerNumber",
                          "GroupType": "ShippingCustomer",
                          "GroupID": "",
                          "Value": "CustomerNumber12346"
                       },
                       {
                          "Name": "BankAccount",
                          "GroupType": "",
                          "GroupID": "",
                          "Value": "NL13TEST0123456789"
                       },
                       {
                          "Name": "BankCode",
                          "GroupType": "",
                          "GroupID": "",
                          "Value": "TESTNL2A"
                       },
                       {
                          "Name": "MerchantImageUrl",
                          "GroupType": "",
                          "GroupID": "",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       },
                       {
                          "Name": "SummaryImageUrl",
                          "GroupType": "",
                          "GroupID": "",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       }
                    ]
                 }
              ]
           }
        }
        

        Authorize response

        JSON gateway response

        Note: If a request is rejected (statuscode 690), then the reason is provided in Services->Afterpay->ErrorResponseMessage>Value and can be used to inform the customer.

        Example response

        {
           "Key": "D5127080BA1D4644856FECDC560FXXXX",
           "Status": {
              "Code": {
                 "Code": 190,
                 "Description": "Success"
              },
              "SubCode": null,
              "DateTime": "2019-03-14T09:22:49+01:00"
           },
           "RequiredAction": null,
           "Services": null,
           "CustomParameters": null,
           "AdditionalParameters": null,
           "RequestErrors": null,
           "Invoice": "testinvoice12345cvc",
           "ServiceCode": "afterpay",
           "IsTest": true,
           "Currency": "EUR",
           "AmountDebit": 10,
           "TransactionType": "I038",
           "MutationType": 3,
           "RelatedTransactions": null,
           "ConsumerMessage": null,
           "Order": null,
           "IssuingCountry": "NL",
           "StartRecurrent": false,
           "Recurring": false,
           "CustomerName": "Test Acceptatie",
           "PayerHash": null,
           "PaymentKey": null
        }
        

        Authorize push

        JSON push response

        Example push

        {
           "Transaction": {
              "Key": "D5127080BA1D4644856FECDC560FXXXX",
              "Invoice": "testinvoice12345cvc",
              "ServiceCode": "afterpay",
              "Status": {
                 "Code": {
                    "Code": 190,
                    "Description": "Success"
                 },
                 "SubCode": null,
                 "DateTime": "2019-03-14T09:22:49"
              },
              "IsTest": true,
              "Order": null,
              "Currency": "EUR",
              "AmountDebit": 10,
              "TransactionType": "I038",
              "Services": null,
              "CustomParameters": null,
              "AdditionalParameters": null,
              "MutationType": 3,
              "RelatedTransactions": null,
              "IsCancelable": false,
              "IssuingCountry": "NL",
              "StartRecurrent": false,
              "Recurring": false,
              "CustomerName": "Test Acceptatie",
              "PayerHash": null,
              "PaymentKey": null
           }
        }
        

        CancelAuthorize

        If an Authorize transaction has been partially captured or not at all, and the customer wishes to cancel the (remaining) order, the (remaining) authorized amount can be cancelled by performing a CancelAuthorize call. It is advised to do this, as it also opens up the customer's spending limit at AfterPay.

        CancelAuthorize request

        The CancelAuthorize request cancels the entire authorisation, independent of which AmountCredit is provided in the request.

        Service specific parameters

        ParameterTypeRequiredRecommendedDescription
        OriginalTransactionKeyStringYesN/AThis is a basic parameter. Transaction key of the Authorize transaction.
        InvoiceStringYesN/AThis is a basic parameter. Invoice number given to the CancelAuthorize transaction. Strongly adviced to use the same invoice number of the Authorize transaction
        Basic parameters

        Example request

        {
           "Currency": "EUR",
           "AmountCredit": 10,
           "OriginalTransactionKey": "F86579ECED1D493887ECAE7C287BXXXX",
           "Invoice": "testinvoice12345cvx",
           "Services": {
              "ServiceList": [
                 {
                    "Name": "afterpay",
                    "Action": "CancelAuthorize"
                 }
              ]
           }
        }
        

        CancelAuthorize response

        Example Response

        {
            "Key": "AD21305248594E949FA380155402XXXX",
            "Status": {
                "Code": {
                    "Code": 190,
                    "Description": "Success"
                },
                "SubCode": null,
                "DateTime": "2019-03-14T12:24:19+01:00"
            },
            "RequiredAction": null,
            "Services": null,
            "CustomParameters": null,
            "AdditionalParameters": null,
            "RequestErrors": null,
            "Invoice": "testinvoice12345cvx",
            "ServiceCode": "afterpay",
            "IsTest": true,
            "Currency": "EUR",
            "AmountCredit": 10,
            "TransactionType": "I014",
            "MutationType": 3,
            "RelatedTransactions": null,
            "ConsumerMessage": null,
            "Order": null,
            "IssuingCountry": null,
            "StartRecurrent": false,
            "Recurring": false,
            "CustomerName": "Test Acceptatie",
            "PayerHash": null,
            "PaymentKey": null
        }
        

        CancelAuthorize push

        Example push

        {
           "Transaction": {
              "Key": "AD21305248594E949FA380155402XXXX",
              "Invoice": "testinvoice12345cvx",
              "ServiceCode": "afterpay",
              "Status": {
                 "Code": {
                    "Code": 190,
                    "Description": "Success"
                 },
                 "SubCode": null,
                 "DateTime": "2019-03-14T12:24:19"
              },
              "IsTest": true,
              "Order": null,
              "Currency": "EUR",
              "AmountCredit": 10,
              "TransactionType": "I014",
              "Services": null,
              "CustomParameters": null,
              "AdditionalParameters": null,
              "MutationType": 3,
              "RelatedTransactions": null,
              "IsCancelable": false,
              "IssuingCountry": null,
              "StartRecurrent": false,
              "Recurring": false,
              "CustomerName": "Test Acceptatie",
              "PayerHash": null,
              "PaymentKey": null
           }
        }
        

        Capture

        A Capture request can be performed on a succesful Authorize transaction. If the capture is succesful, an invoice will be sent to the customer.

        Capture request

        Service specific parameters

        ParameterTypeRequiredRecommendedDescription
        OriginalTransactionKeyStringYesN/AThis is a basic parameter. Transaction key of the Authorize transaction.
        InvoiceStringYesN/AThis is a basic parameter. Invoice number given to the Capture transaction. When performing a full capture or just one partial capture in total, we advise to use the same invoice number as the Authorize transaction. But when performing multiple partial captures, each invoice number has to be unique.
        DescriptionStringNoYesGroupType: Article. Required for partial Capture. Article name/description.
        GrossUnitPriceDecimalNoN/AGroupType: Article. Required for partial Capture. VAT percentage on the article price.
        QuantityStringNoN/AGroupType: Article. Required for partial Capture. Article quantity.
        IdentifierStringNoN/AGroupType: Article. Required for partial Capture. Article number/code.
        ImageUrlStringNoN/AGroupType: Article. URL for the image of this article. It will be turned into a thumbnail and displayed to the customer in MyAfterPay, on the invoice line next to the order item. The linked image must be a rectangle or square, width between 100 pixels and 1280 pixels.
        UrlStringNoN/AGroupType: Article. URL to the article page.
        TypeStringNoN/AGroupType: Article. Article type. Possible values: PhysicalArticle, DigitalArticle, GiftCard, Discount, ShippingFee, Surcharge, Info, ShippingFees.
        UnitCodeStringNoN/AGroupType: Article. Unit in which the article is measured, such as pieces, liters, kilograms, etc.
        SummeryImageUrlStringNoN/ACurrently does not do anything, but in the future, this might be used by AfterPay to show an image to the customer for the entire order. You can decide to send this in so that if/when AfterPay implements this, you will automatically use this feature.
        MerchantImageUrlStringNoN/AImage URL for the merchants brand. This image is shown at the top of the order page in MyAfterPay.
        Basic parameters

        Example request

        {
           "OriginalTransactionKey": "D5127080BA1D4644856FECDC560FXXXX",
           "Currency": "EUR",
           "AmountDebit": 10,
           "Invoice": "testinvoice12345cvc",
           "Services": {
              "ServiceList": [
                 {
                    "Name": "afterpay",
                    "Action": "Capture",
                    "Parameters": [
                       {
                          "Name": "Description",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Blue Toy Car"
                       },
                       {
                          "Name": "GrossUnitPrice",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "10.00"
                       },
                       {
                          "Name": "VatPercentage",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "21"
                       },
                       {
                          "Name": "Quantity",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "1"
                       },
                       {
                          "Name": "Identifier",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Articlenumber12345"
                       },
                       {
                          "Name": "ImageUrl",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       },
                       {
                          "Name": "Url",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/"
                       },
                       {
                          "Name": "Type",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "PhysicalArticle"
                       },
                       {
                          "Name": "UnitCode",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Pieces"
                       },
                       {
                          "Name": "SummaryImageUrl",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       },
                       {
                          "Name": "MerchantImageUrl",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       }
                    ]
                 }
              ]
           }
        }
        

        Refund

        A Refund request can be performed on a succesful Pay or Capture transaction.

        Base JSON request

        Use the base request as instructed on this page

        Refund request

        When performing a full Refund, no article information is required in the request; the original transaction key of the Pay or Capture transaction will suffice. When performing a partial Refund, the information of the refunded article(s) is required in the request.

        Secondly, when performing a partial Refund, the AmountCredit should equal the sum of the article amounts.

        Parameters

        Service specific parameters

        ParameterTypeRequiredRecommendedDescription
        OriginalTransactionKeystringRequiredThis is a basic parameter. Transaction key of the Pay or Capture transaction.
        InvoicestringRequiredThis is a basic parameter. Invoice number given to the Refund transaction. Invoice numbers for refunds have to be unique. We recommend to use the same invoice number of the Pay or Capture transaction with an extra addition at the end like _1 or _R
        RefundTypestringGroupType: Article. Required for partial Refund. Possible values: Return, Refund. Return should be used for products that have been returned by the customer. Refund should be used for goodwill refunds, such as “the product was damaged, you’ll receive (part of) the purchase price back”.
        DescriptionstringGroupType: Article. Required for partial Refund. Article name/description.
        GrossUnitPricedecimalGroupType: Article. Required for partial Refund. Article price including VAT.
        VatPercentagedecimalGroupType: Article. Required for partial Refund. VAT percentage on the article price.
        QuantitystringGroupType: Article. Required for partial Refund. Article quantity.
        IdentifierstringGroupType: Article. Required for partial Refund. Article number/code.
        ImageUrlstringGroupType: Article. URL for the image of this article. Tt will be turned into a thumbnail and displayed to the customer in MyAfterPay, on the invoice line next to the order item. The linked image must be a rectangle or square, width between 100 pixels and 1280 pixels.
        UrlstringGroupType: Article. URL to the article page.
        TypestringGroupType: Article. Article type. Possible values: PhysicalArticle, DigitalArticle, GiftCard, Discount, ShippingFee, Surcharge, Info, ShippingFees.
        UnitCodestringGroupType: Article. Unit in which the article is measured, such as pieces, liters, kilograms, etc.
        MarketPlaceSellerIdstringGroupType: Article Only applicable if used in combination with the service Marketplaces. Buckaroo merchant ID of the seller account for the article. Mandatory for each article. Each Seller ID should also be included in the Marketplace service request.
        SummaryImageUrlstringCurrently does not do anything, but in the future, this might be used by AfterPay to show an image to the customer for the entire order. You can decide to send this in so that if/when AfterPay implements this, you will automatically use this feature.
        MerchantImageUrlstringImage URL for the merchants brand. This image is shown at the top of the order page in MyAfterPay.
        Basic parameters

        Example request

        {
           "OriginalTransactionKey": "CE82E23DDF1740C79710B1BB9F25XXXX",
           "Currency": "EUR",
           "AmountCredit": 10,
           "Invoice": "testinvoice12345cvs",
           "Services": {
              "ServiceList": [
                 {
                    "Name": "afterpay",
                    "Action": "Refund",
                    "Parameters": [
                       {
                          "Name": "RefundType",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Return"
                       },
                       {
                          "Name": "Description",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Blue Toy Car"
                       },
                       {
                          "Name": "GrossUnitPrice",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "10.00"
                       },
                       {
                          "Name": "VatPercentage",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "21"
                       },
                       {
                          "Name": "Quantity",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "1"
                       },
                       {
                          "Name": "Identifier",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Articlenumber12345"
                       },
                       {
                          "Name": "ImageUrl",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       },
                       {
                          "Name": "Url",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/"
                       },
                       {
                          "Name": "Type",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "PhysicalArticle"
                       },
                       {
                          "Name": "UnitCode",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "Pieces"
                       },
                       {
                          "Name": "SummaryImageUrl",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       },
                       {
                          "Name": "MerchantImageUrl",
                          "GroupType": "Article",
                          "GroupID": "1",
                          "Value": "https://www.buckaroo.nl/img/logo_menu.png"
                       }
                    ]
                 }
              ]
           }
        }
        

        Refund response

        Parameters

        Basic parameters

        Example response

        {
           "Key": "721559A240B34F7B9C3E266BD75CXXXX",
           "Status": {
              "Code": {
                 "Code": 190,
                 "Description": "Success"
              },
              "SubCode": {
                 "Code": "S990",
                 "Description": "The request was successful."
              },
              "DateTime": "2019-03-14T11:29:31"
           },
           "RequiredAction": null,
           "Services": null,
           "CustomParameters": null,
           "AdditionalParameters": null,
           "RequestErrors": null,
           "Invoice": "testinvoice12345cvs",
           "ServiceCode": "afterpay",
           "IsTest": true,
           "Currency": "EUR",
           "AmountCredit": 10,
           "TransactionType": "C041",
           "MutationType": 1,
           "RelatedTransactions": [
              {
                 "RelationType": "refund",
                 "RelatedTransactionKey": "CE82E23DDF1740C79710B1BB9F25XXXX"
              }
           ],
           "ConsumerMessage": null,
           "Order": null,
           "IssuingCountry": null,
           "StartRecurrent": false,
           "Recurring": false,
           "CustomerName": "Test Acceptatie",
           "PayerHash": null,
           "PaymentKey": "AF55BB29923A421387E8CB4C2B0CXXXX"
        }
        

        Refund push

        Parameters

        Basic parameters

        Example push

        {
           "Transaction": {
              "Key": "721559A240B34F7B9C3E266BD75CXXXX",
              "Invoice": "testinvoice12345cvs",
              "ServiceCode": "afterpay",
              "Status": {
                 "Code": {
                    "Code": 190,
                    "Description": "Success"
                 },
                 "SubCode": null,
                 "DateTime": "2019-03-14T11:29:31"
              },
              "IsTest": true,
              "Order": null,
              "Currency": "EUR",
              "AmountCredit": 10,
              "TransactionType": "C041",
              "Services": null,
              "CustomParameters": null,
              "AdditionalParameters": null,
              "MutationType": 1,
              "RelatedTransactions": [
                 {
                    "RelationType": "refund",
                    "RelatedTransactionKey": "CE82E23DDF1740C79710B1BB9F25XXXX"
                 }
              ],
              "IsCancelable": false,
              "IssuingCountry": null,
              "StartRecurrent": false,
              "Recurring": false,
              "CustomerName": "Test Acceptatie",
              "PayerHash": null,
              "PaymentKey": null
           }
        }
        

        Was this article helpful?

        What's Next