Prepare CheckOut

The Prepare Checkout section of our Developers has been created in order to help you to set up your checkout in the way that AfterPay is supported in the best way possible. Here you get an overview of what information needs to be collected from the customer, what logotype to use, how to present the payment options on your pay page and how to deal with error codes. All in all be an increase of conversion, higher order values and the likelihood of returning customers.

Collecting Consumer Information

In the following table, you can see which information is required per country for sending a complete request. However, check out our Customer LookUp functionality under 5.1 to further reduce the information that has to be provided by the consumer.

Salutation SSN First Name Last Name Email Mobile Phone Date of Birthday Country Postal Code Street Street Number City
Germany
Austria
Switzerland
Netherlands
Belgium
Sweden
Norway
Finland
Denmark

Payment Options

AfterPay, as illustrated in the After Basics offers various invoice and part payment options. Here is a short recap of how we have structured them and a best-practice example of the way they shall be displayed. To get a more detailed explanation of how to display the different payment option, check our Display Guidelines.

Invoice Part payment
A14-day invoice BCampaign invoice CFlex payment DFixed instalments
Payment Options (Pay after delivery, Pay after midsummer, Flex - Pay ay your own pace, amount per month)
For specific verticals, AfterPay makes it possible to generate a merchant-specific consolidated invoice that is a standalone AfterPay payment option. It allows consolidating all purchases made by the customer into a single invoice. If the consolidated invoice is used, no other AfterPay payment options are presented at checkout. Below is how the consolidated invoice is presented at checkout.
Consolidated Invoice

From the drop-down, please, select suitable language and refer to the Display Guideline to get more information about payment options and how they are presented at checkout.

Logos

For convenience and a familiar customer experience, please integrate/enclose the AfterPay logo in your Checkout, next to the payment method. Implement it by using our URL, not by downloading the image. The AfterPay logos are hosted on a Content Delivery Network (CDN) to ensure the best performance and availability for your website. Furthermore, you do not have to care about changes. That is all done by AfterPay.

We provide two types of logos through our CDN - .svg and .png. We recommend using the AfterPaylogo as .svg file regarding to the quality and size of the file. If you prefer .png just change the end of the URL to png. We also offer the AfterPaylogo in different colourschemes. Depending on your individual website background, choose the AfterPaylogo that fits best. Please note that the original logo is the default logo. The other logotypes should only be considered if the readability is not ensured or if the colours are incompatible.

Copy URL Logo
AfterPay Original Logo in SVG, 5.72Kb https://cdn.myafterpay.com/logo/AfterPay_logo.svg original AfterPay logo
AfterPay Black Logo in SVG, 5.44Kb https://cdn.myafterpay.com/logo/AfterPay_logo_black.svg black AfterPay logo
AfterPay Grey Logo in SVG, 5.65Kb https://cdn.myafterpay.com/logo/AfterPay_logo_grey.svg grey AfterPay logo
AfterPay White Logo in SVG, 5.61Kb https://cdn.myafterpay.com/logo/AfterPay_logo_white.svg

Error Codes

In the following you can see the various error codes. You can also download a spreadsheet with the corresponding error messages and action codes.

Download error codes

Validation error messages

Error Code Description Possible action code
400.000 Unknown error
Unavailable
400.001 Request body missing
Unavailable
400.002 Value is required Unavailable
AskConsumerToReEnterData
400.003 Value out of range Unavailable
AskConsumerToReEnterData
400.004 Value format is incorrect Unavailable
AskConsumerToReEnterData
400.005 A string value exceeds maximum length of {value} Unavailable
AskConsumerToReEnterData
400.006 A string value with minimum length {value} is required Unavailable
AskConsumerToReEnterData
400.007 A decimal value has more than allowed decimal digits Unavailable
AskConsumerToReEnterData

Please notice that besides to the error code and action code you will also get field reference that will help you to understand which field caused an error. For example, you may get 400.004 error with the action code "AskConsumerToReEnterData" and field reference "customer.mobilePhone" that means that customer has entered mobile phone number that was in incorrect format and customer has to insert phone number in a correct format.

Business error messages

Error Code Description Action code Field reference
400.001 Request body is empty or invalid AskConsumerToReEnterData request
400.100 Order number is already used on the client Unavailable order.number
400.101 TotalNetAmount doesn't match with items prices Unavailable order.totalNetAmount
400.102 Order gross amount doesn't match with items prices Unavailable order.totalGrossAmount
400.103 The provided customerNumber differs from the customerNumber specified in the checkout AskConsumerToReEnterData customer.customerNumber
400.108 Invalid payment method selected Unavailable payment.type
400.109 A valid contract id is required Unavailable payment.contractId
400.110 Installment profile not found Unavailable payment.installment.profileNo
400.111 Installment profile plans missing Unavailable -
400.112 Monthly installment amount is invalid Unavailable payment.installment.numberOfInstallments
400.113 Number of installments is not allowed for amount Unavailable payment.installment.numberOfInstallments
400.114 Invalid AccountProfileNo Unavailable paymentInfo.account.profileNo
400.115 Reservation not found Unavailable -
400.117 Cannot capture the order because full capture can only be done for the entire reserved amount within the given tolerance level. Unavailable -
400.118 Capture partial cannot capture more than the current reservation balance Unavailable -
400.119 Order items missing Unavailable -
400.120 Cannot capture the order as capture with the specified number is already exists Unavailable -
400.121 Reservation, to which this order is linked to does not have a checkout Unavailable -
400.124 The grand total of gross unit prices must be positive Unavailable orderItems[].grossUnitPrice
400.126 Cannot refund the order because specified capture was not created from reservation, to which this order is linked to Unavailable -
400.127 Cannot refund the order as refund amount is higher than the capture balance amount Unavailable -
400.128 Cannot refund the order because there are no captures related to this order Unavailable -
400.129 Cannot cancel the order, because it is partially or fully captured Unavailable -
400.130 Cannot cancel the order when the current balance of authorization, to which this order is linked to, is zero Unavailable -
400.131 Order not found Unavailable -
400.132 Capture not found Unavailable -
400.133 Refund not found Unavailable -
400.134 Void not found Unavailable -
400.135 Customer not found Unavailable -
400.136 Contract already exists Unavailable -
400.137 When order items are provided then capture number is mandatory Unavailable -
400.138 Shipping details not found Unavailable -
400.139 Valid BankCode is required Unavailable payment.directDebit.bankCode
400.140 Valid BankAccount is required Unavailable payment.directDebit.bankAccount
400.142 Checkout not found Unavailable -
400.144 Validation failed Unavailable -
400.146 Capture amount can't be with opposite sign to Reservation amount Unavailable order.totalGrossAmount
400.147 Void amount can't be with opposite sign to Reservation amount Unavailable cancellationDetails.totalGrossAmount
400.148 Cannot refund a negative invoice Unavailable -
400.150 Installment profile is not valid for amount Unavailable payment.installment.profileNo
400.151 IdempotencyKey is aleady used with different endpoint URL Unavailable -
400.152 DirectDebit is not enabled for client Unavailable -
400.153 A valid order number can include alphanumeric characters, dashes and underscores Unavailable order.number
400.154 totalGrossAmount cannot be negative Unavailable -
400.155 In case of partial request the totalGrossAmount is required Unavailable -
400.156 The country code is not valid for this customer AskConsumerToReEnterData customer.address.countryCode
400.157 The currency code is not valid for this customer Unavailable -
400.158 Reservation is already cancelled or captured Unavailable -
400.159 Item gross price, net price and VAT amount must be all positive or all negative Unavailable order.items[].grossUnitPrice
400.160 Gross unit price must be equal to Net unit price plus VAT amount Unavailable order.items[].grossUnitPrice
400.161 Item net price can't be bigger than gross price Unavailable order.items[].netUnitPrice
400.162 Item VAT amount can't be bigger than gross price Unavailable order.items[].vatAmount
400.163 The provided orderNumber differs from the orderNumber specified in the checkout Unavailable -
400.164 The provided Amount differs from the Amount specified in the checkout Unavailable -
400.165 The provided TotalOrderValue differs from the TotalOrderValue specified in the checkout Unavailable -
400.166 The provided currency differs from the currency specified in the checkout Unavailable -
400.167 File format is not supported. We support the following formats: {value} Unavailable -
400.168 Order items must be specified if order amount is increased within the allowed tolerance level Unavailable order.items
400.169 Order items must be specified if order amount has changed Unavailable order.totalGrossAmount

Customer facing error messages to API

Error Code Language Description
200.001 EN Sorry, the age you entered does not meet the minimum requirement (18 years), please choose a different payment method or reenter your date of birth
NO Du må være minst 18 år for å betale med AfterPay, vennligst velg en annen betalingsmetode
SE Du måste ha fyllt 18 år för att kunna få handla med AfterPay
FI Pahoittelemme, sinun tulee olla vähintään 18-vuotias voidaksesi käyttää AfterPay-maksutapaa
DK Du skal være over 18 år, for at kunne benytte AfterPay. Du må derfor vælge en anden betalingsmetode
DE Das Alter entspricht nicht dem Mindestalter (18 Jahre). Bitte eine andere Zahlungsmethode auswählen
200.002 EN Sorry, the payment method is currently not available. Please choose another payment method
NO Bedrifter kan ikke betale med AfterPay, vennligst velg en annen betalingsmetode
SE Betalningsmetoden du önskat är inte tillgänglig, vänligen välj ett annat alternativ
FI Pahoittelemme, yritys ei voi käyttää AfterPay-maksatapaa
DK Handel via B2B er pt. ikke mulig
DE Die Zahlungsmethode ist leider derzeit nicht verfügbar. Bitte eine andere Zahlungsmethode auswählen
200.003 EN Sorry, the payment method is currently not available. Please choose another payment method
NO AfterPay er ikke tilgjengelig i valgt land
SE Betalningsmetoden du önskat är inte tillgänglig, vänligen välj ett annat alternativ
FI Pahoittelemme, valitsemasi maksutapa ei ole käytössä alueellasi. Ole hyvä, ja valitse toinen maksutapa
DK Betalingsmetoden er desværre ikke mulig. Vælg venligst en anden betalingsmetode
DE Die Zahlungsmethode ist leider derzeit nicht verfügbar. Bitte eine andere Zahlungsmethode auswählen
200.004 EN Pick-Up-point can not be used as billing address
NO Hentested er ikke gyldig som fakturaadresse
SE Upphämtningsstället kan inte användas som faktureringsadress
FI Nouto-osoitetta ei voi käyttää laskutusosoitteena
DK Afhentningssted kan ikke benyttes som fakturaadresse
DE Packstation ist nicht als Rechnungsadresse erlaubt
200.005 EN Address of the Pick-Up-point is invalid, please doublecheck and correct it
NO Ugyldig hentested
SE Adressen till upphämtningsstället stämmer inte, vänligen kontrollera och uppdatera den
FI Nouto-osoite on virheellinen. Ole hyvä ja tarkista osoite
DK Afhentningsadressen er ukendt. Venligst kontroller det indtastede
DE Die Adresse der Packstation ist nicht korrekt
200.006 EN Billing and delivery address must be the same
NO Faktura- og leveringsadresse må være den samme
SE Faktureringsadress och leveransadress måste vara samma
FI Laskutus- ja toimitusosoitteiden tulee olla samat
DK Faktura- og leveringsadresse skal være den samme
DE Rechnungs- und Lieferadresse dürfen nicht voneinander abweichen
200.101 EN This billing address is invalid, please double check and correct it
NO Ugyldig fakturaadresse, vennligst kontroller dine opplysninger
SE Faktureringsadressen är ogiltig, vänligen kontrollera och uppdatera den
FI Laskutusosoite on virheellinen. Ole hyvä ja tarkista osoite
DK Faktueringsadressen er ukendt. Venligst kontroller det indtastede
DE Die Rechnungsadresse ist ungültig, bitte überprüfen und korrigieren
200.102 EN This delivery address is invalid, please double check and correct it
NO Ugyldig leveringsadresse, vennligst kontroller dine opplysninger
SE Faktureringsadressen är ogiltig, vänligen kontrollera och uppdatera den
FI Toimitusosoite on virheellinen. Ole hyvä ja tarkista osoite
DK Leveringsadressen er ukendt. Venligst kontroller det indtastede
DE Die Lieferadresse ist ungültig, bitte überprüfen und korrigieren
200.103 EN The billing address was corrected, please verify
NO Fakturaadresse er endret
SE Fakturaadressen är ändrad
FI Laskutusosoite muutettu
DK Fakturaadresse ændret
DE Die Rechnungsadresse wurden korrigiert, bitte bestätigen
200.104 EN The delivery address was corrected, please verify
NO Leveringsadressen er endret
SE Fakturaadressen är ändrad
FI Toimitusosoite muutettu
DK Leveringsadresse ændret
DE Die Lieferadresse wurden korrigiert, bitte bestätigen
200.900 EN Sorry, the payment method is currently not available. Please choose another payment method
NO Betalingsmetoden er ikke tilgjengelig, vennligst velg en annen betalingsmetode
SE Betalningsmetoden du önskat är inte tillgänglig, vänligen välj ett annat alternativ
FI Pahoittelemme, valittu maksutapa ei tällä hetkellä ole mahdollinen. Ole hyvä ja valitse toinen maksutapa
DK Betalingsmetoden er desværre ikke mulig. Vælg venligst en anden betalingsmetode
DE Die Zahlungsmethode ist leider derzeit nicht verfügbar. Bitte eine andere Zahlungsmethode auswählen
200.901 EN Sorry, the payment method is currently not available. Please choose another payment method
NO Vi kan dessverre ikke gjennomføre din betaling med AfterPay, vennligst velg en annen betalingsmetode
SE Betalningsmetoden du önskat är inte tillgänglig, vänligen välj ett annat alternativ
FI Emme valitettavasti voi hyväksyä ostostasi AfterPay-maksutavalla. Ole hyvä ja valitse toinen maksutapa
DK Vi kan desværre ikke godkende din kreditansøgning. Vælg derfor en anden betalingsmetode
DE Die Zahlungsmethode ist leider derzeit nicht verfügbar. Bitte eine andere Zahlungsmethode auswählen
200.902 EN Sorry, the payment method is currently not available. Please choose another payment method
NO Vi kan dessverre ikke gjennomføre din betaling med AfterPay, vennligst velg en annen betalingsmetode
SE Betalningsmetoden du önskat är inte tillgänglig, vänligen välj ett annat alternativ
FI Emme valitettavasti voi hyväksyä ostostasi AfterPay-maksutavalla. Ole hyvä ja valitse toinen maksutapa
DK Betalingsmetoden er desværre ikke mulig. Vælg venligst en anden betalingsmetode
DE Die Zahlungsmethode ist leider derzeit nicht verfügbar. Bitte eine andere Zahlungsmethode auswählen
200.903 EN Sorry, the payment method is currently not available. Please choose another payment method
NO Du har nådd din grense for å betale med AfterPay, vennligst velg en annen betalingsmetode for å gjennomføre ditt kjøp
SE Betalningsmetoden du önskat är inte tillgänglig, vänligen välj ett annat alternativ
FI Emme valitettavasti voi hyväksyä ostostasi AfterPay-maksutavalla. Ole hyvä ja valitse toinen maksutapa
DK Du har nu handlet op til din limit og du bedes derfor betale af på din saldo, før du kan handle mere
DE Die Zahlungsmethode ist leider derzeit nicht verfügbar. Bitte eine andere Zahlungsmethode auswählen
200.908 EN The bank account entered is invalid. Please double check and correct it
NO Ugyldige bankdetaljer
SE Kontonumret du fyllt i stämmer inte, vänligen kontrollera och uppdatera det
FI Syötetty tilinumero on virheellinen. Ole hyvä ja tarkista numero
DK Bankkonto er ikke korrekt udfyldt. Venligst kontroller det indtastede
DE Die eingegebenen Bankdaten sind ungültig, bitte überprüfen und korrigieren

Terms & Conditions

Before AfterPay can accept any payment request the consumer must accept the AfterPay payment terms.

Languages URLs Text
Norwegian https://documents.myafterpay.com/consumer-terms-conditions/no_no/YOURMERCHANTID Jeg godkjenner vilkårene for AfterPay.
English https://documents.myafterpay.com/consumer-terms-conditions/en_no/YOURMERCHANTID I have read and accepted AfterPay consumer Terms and Conditions.

Data Privacy Statement

AfterPay reviews and evaluates the data provided and in case of legitimate interest performs a data exchange with other companies and credit rating agencies.

AfterPay Information Text

The website should inform the consumer about the AfterPay payment method. The text underneath should be displayed in the web shop. The preferred place for the text is on the customer service pages. Placement in the web shop check-out is also allowed.

AfterPay Order Confirmation

When possible the merchant should inform the consumer that payment handling is done by AfterPay. The consumer will receive the actual invoice directly from AfterPay. The following text can be used.