Svg Vector Icons : http://www.onlinewebfonts.com/icon

Payments

Tikkie Fast Checkout

Boost your ecommerce conversion rate by enabling customers to checkout in just a few seconds.

Tutorials

On this page you will find a full tutorial, which will guide you through the different functionalities of the Tikkie Fast Checkout API. You can also use this Postman Collection to learn and explore what you can do with the Tikkie Fast Checkout API.

Getting a merchant token

Tikkie Fast Checkout API uses a so called 'merchant token' for authentication. To use the API, you need to obtain this merchant token. For production a token will be provided to you during the on boarding process. In the Sandbox environment however you can create a merchant token yourself using below API call.

POST /v1/tikkie/fastcheckout/merchant

Request Attributes

Name Type In Required Description
API-Key String Header true Consumer key obtained after app registration on developer portal
curl -X POST \
https://api-sandbox.abnamro.com/v1/tikkie/fastcheckout/merchant \
-H 'API-Key: {your_api_key}' \
-H 'Content-Type: application/json'

Response Attributes

Name Type In Required Description
merchantToken String Body true The token that can be used to access the API.
{
    "merchantToken": "62dbfd2f-9d22-413b-bd68-8618bb12c270"
}

The following tutorials will assume you have a valid API key and Merchant Token.

Calling the Tikkie Fast Checkout API

After obtaining your merchant token, you can call the endpoint of the Tikkie Fast Checkout API. Below steps will go through the process of creating an order, finalizing the payment and then checking the status of the order.

  1. Start by creating an order, via the post order operation. This will get you an order token (suggestion: save it somewhere since you will not be able to retrieve it later on)
  2. Complete the payment by using the URL returned to you in step 1
  3. Retrieve the status and shipping address details of your order by using GET Order. In a production context you may want to make use of our webhook functionality to prevent having to do polling

Create order

This operation will create a new order. When the customer of your (web)shop visits the checkout page this operation needs to be called in order to generate the URL needed for the 'Tikkie Fast Checkout' button.

Request attributes Value
Method POST
Path v1/tikkie/fastcheckout/orders
Headers X-Merchant-Token: {your_merchant_token}
API-Key: {your_api_key}
Body The payload, containing the details of the order. See the technical details for a full specification of the format.

Formatting of the payload:

{
  "referenceId": "order-1234",
  "shippingCostsInCents": 690,
  "discountInCents": 0,
  "currency": "EUR",
  "expiration": 700,
  "redirectUrl": "https://www.yourdomain.nl/finishorder/123456789",
  "notificationUrl": "https://www.yourdomain.nl/orderupdate",
  "items": [
    {
      "itemName": "MobilePhone",
      "priceInCents": 20000,
      "quantity": 1
    }
  ]
}

The full url looks like:

https://api-sandbox.abnamro.com/v1/tikkie/fastcheckout/orders

An example of a call with curl:

curl -X POST \
  https://api-sandbox.abnamro.com/v1/tikkie/fastcheckout/orders \
  -H 'API-Key: {your_api_key}' \
  -H 'Content-Type: application/json' \
  -H 'X-Merchant-Token: {your_merchant_token}' \
  -d '{
  "referenceId": "order-1234",
  "shippingCostsInCents": 690,
  "discountInCents": 0,
  "currency": "EUR",
  "expiration": 700,
  "redirectUrl": "https://www.yourdomain.nl/finishorder/123456789",
  "notificationUrl": "https://www.yourdomain.nl/orderupdate",
  "items": [
    {
      "itemName": "MobilePhone",
      "priceInCents": 20000,
      "quantity": 1
    }
  ],
}'

This specific call might return:

{
    "checkoutUrl": "https://checkout.sbx.tikkie.me/checkout/8f442664-adff-481c-af76-aab9cbc90790",
    "orderToken": "8f442664-adff-481c-af76-aab9cbc90790"
}

Make the payment

Of the return attributes, the checkoutUrl is of special importance since this is the value that you need to provide to your customer in order to pay. For our tutorial we can now copy/paste this url and open it in our browser. We can now finish the payment in our sandbox environment. Once the payment is done proceed to the next step.

Retrieve order status

This operation will fetch the order for a given orderToken and return its status. It will also include payer information if the order was paid for. Typically you will not use this operation if your web application supports webhooks.

Request attributes Value
Method GET
Path v1/tikkie/fastcheckout/order/{your_order_token}
Headers X-Merchant-Token: {your_merchant_token}
API-Key: {your_api_token}

The full url looks like:

https://api-sandbox.abnamro.com/v1/tikkie/fastcheckout/order/{your_order_token}

An example of a call with curl:

curl -X GET \
https://api-sandbox.abnamro.com/v1/tikkie/fastcheckout/orders/{your_order_token} \
-H 'API-Key: {your_api_key}' \
-H 'Content-Type: application/json' \
-H 'X-Merchant-Token: {your_merchant_token}'

This specific call might return:

{
    "orderToken": "8f442664-adff-481c-af76-aab9cbc90790",
    "referenceId": "order-1234",
    "shippingCostsInCents": 10,
    "discountInCents": 0,
    "currency": "EUR",
    "items": [
        {
            "itemName": "Mobile",
            "priceInCents": 20000,
            "quantity": 1
        }
    ],
    "status": "PAID",
    "payer": {
        "companyName": null,
        "firstName": "John",
        "lastName": "Doe",
        "email": "johndoe@something.com",
        "phoneNumber": "+31612345678",
        "shippingAddress": {
            "street": "Newstreet",
            "houseNumber": "123",
            "addition": null,
            "postalCode": "1010AB",
            "city": "AMSTERDAM",
            "country": "NL"
        }
    }
}