heroImage

    Menu

    Please select your page

    Plugin

    H1 payment plugin for AfterPay and Buy Now Pay Later

    AfterPay is integrated in the <h1> e-commerce platform (former One Stop Webshop).

    Website:
    https://www.h1.nl/

    Type:
    Plugin


    Introduction

    This guide describes the steps to quickly configure, test and activate the AfterPay payment methods in your H1 platform.

    H1 currently offers this payment method:

    • 14-day invoice - This is the default 14-day invoice payment method in AfterPay. It is always available in every market where AfterPay operates. It is primarily meant for business-to-consumer sales.
    • Direct Debit - This is a Direct Debit version of the 14-day invoice payment method Instead of receiving an invoice to be paid via their bank, the customer enters their bank details, and the money is immediately deducted from their bank account.

    The available payment methods per country for H1 can be found in this table:

    Country 14-day invoice Direct Debit Campaign invoice Fixed instalments Flex payment B2B invoice
    The Netherlands
    x
    x
    Belgium
    x
    Germany
    Austria
    Switzerland
    Sweden
    Norway
    Finland
    Denmark


    Setup

    In this chapter we will explain how you can configure AfterPay for your H1 platform.

    AfterPay configuration in H1

    To set up AfterPay in your platform, you must send the email containing the necessary information to partners@oswshop.nl. H1 will respond to this mail with the confirmation that they configured the key. Please follow the remaining instructions from H1 to activate AfterPay on your production environment.

    Testing

    After completing the setup the next step is to test the connection.

    Standard test scenarios

    Please submit the following test scenarios. To check your own test transactions proceed to paragraph check test order. Complete the table with your order numbers and send it to your AfterPay Implementation Manager. You can put multiple test cases in one order but please refer to the right order number after each testcase.

    # Test case Order number
    1. Test an order with multiple products
    2. Test an order with a fixed discount
    3. Test an order with a percentual discount
    4. Test an order with a shipping fee
    5. Test an order with an alternate delivery address
    6. Test an order with pick-up points (if applicable)
    7. Test an order with store pick-up (if applicable)
    8. Test an order with a house number addition
    9. Test and make sure the VAT is correcly received by AfterPay

    Payment method scenarios

    After you tested all standard scenarios for the 14-day invoice you should start testing the other payment methods you activated. Please complete the tables with your order numbers and send them to your AfterPay Implementation Manager.



    If you want to integrate Direct Debit please proceed with this test order:

    # Test case Order number
    D-1. Test an order with the Direct Debit payment method

    Customer facing messages

    It is also necessary to check if the error messages are correctly shown to the customer.

    • Test a rejected authorize. Please make sure that the customer friendly message is displayed correctly in the check-out.
    • Test validation error. Please make sure that the customer friendly message is displayed correctly in the check-out.

    Check test order

    You are able to verify the transactions on the AfterPay side by yourself. You can do this with the "GET ORDER" call. You can send these calls for example with Postman. The response will show you how the transactions a registered on the AfterPay side. Documentation for the "GET ORDER" call can be found below.

    GET /api/v3/orders/{orderNumber}

    Returns the contents of the specified order

    Visual guidelines

    In this chapter we will explain the AfterPay visual guidelines you need to apply to your webshop.

    Logos and banners

    For convenience and a familiar customer experience, please integrate/enclose the AfterPay logo in your Checkout next to the payment method. Please refer to our Merchant Playbook for full details on how to make the customer experience smooth and frictionless.

    When Implementing the AfterPay logo throughout the shopping experience please ensure you are 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, which are all done by AfterPay.

    We provide two types of logos through our CDN - .svg and .png. We recommend using the AfterPay logo as a .svg file with regard 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 AfterPay logo in different color schemes. Depending on your individual website background, choose the AfterPay logo that fits best.

    DescriptionCopy URLLogo
    AfterPay Checkout Logo in SVG, 4.3Kbhttps://cdn.myafterpay.com/logo/AfterPay_logo_checkout.svgAfterPay Checkout Logo in SVG, 4.3Kb
    AfterPay Black Logo in SVG, 5.44Kbhttps://cdn.myafterpay.com/logo/AfterPay_logo_black.svgAfterPay Black Logo in SVG, 5.44Kb
    AfterPay White Logo in SVG, 5.61Kbhttps://cdn.myafterpay.com/logo/AfterPay_logo_white.svgAfterPay White Logo in SVG, 5.61Kb

    Terms and conditions

    AfterPay mandates that it is mandatory for a consumer to be presented with AfterPay's terms and conditions and Privacy Policy upon checkout. Thus the option to display the T&C should be always enabled in the plugin configuration. In certain cases where you would like to incorporate the AfterPay T&C and Privacy Policy within your own Terms and Conditions, this must be done only with approval from AfterPay's legal counsel. After approval include the country specific T&C and Privacy Policy resources.

    Go-Live

    In this chapter we will explain which steps you need to take to enable the payment method on production. For the final go-live a contract between you and AfterPay is required.

    Configure live mode

    After you have successfully completed the tests, AfterPay will share the live keys. Foward the email containing the necessary information to partners@oswshop.nl. H1 will respond to this mail with the confirmation that they configured the production key. Please follow the remaining instructions from H1 to activate AfterPay on your production environment.

    Last check (Only applicable for the BeNeLux)

    Now that AfterPay is live, we only have to check whether orders are also coming in properly.
    You can test this per AfterPay connection by placing a rejected order:

    STEP 1
    Go to the webshop, and place a product in the shopping cart.

    STEP 2
    Go to checkout and fill in the necessary information, for the email address you have to enter rejection@afterpay.nl.

    STEP 3
    Choose the payment method AfterPay and finish the order.

    RESULT
    The AfterPay order should be rejected. If this is not the case and instead you receive a technical error or an authorization error please contact your AfterPay Implementation Manager.

    Done

    Congratulations! You just went live with your AfterPay connection. Please notify your AfterPay Implementation Manager that you went live. If you encounter any issues in the upcoming week you can contact your AfterPay Implementation Manager. After that period you can contact our local Merchant Desk for help.

    Introduction to the AfterPay Merchant Portal

    You can go to the Merchant Portal here. Once logged in, you will also see an in-depth guide on how to best use it.

    In the merchant portal you can:

    • View and mutate your AfterPay orders
    • Get financial reports
    • Setup your branding in the AfterPay systems