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.

Technical Details

Open API Specification

Click here to download the Open API Specification of Tikkie Fast Checkout API in yaml format.

POST Order

POST /v1/tikkie/fastcheckout/orders

This operation will create a new order. The details of the order are specified in the payload.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key obtained after app registration on developer portal
X-Merchant-Token String Header true To create a merchant token please refer here
referenceId String Body true This field can be used and referenceId and may include any value
shippingCostsInCents Integer Body true Total shipping costs of the order
discountInCents Integer Body false Any discount that should be removed from total cost of the order
currency String Body true Currency of the amounts used. Currently only EUR is supported
expiration Integer Body true Expiration of the order in seconds, e.g. 900 when order expires in 15 minutes
redirectUrl String Body true URL that the customer is redirected to after completing the payment
notificationUrl String Body false URL for webhook
addressRequired Boolean Body true Whether an address is required to fulfill the order (Not supported yet)
items String Body true Array of all the items from customer's shopping cart
itemName String Body true Name of the item
priceInCents Integer Body true Price of the item in cents
quantity Integer Body true Quantity of the item in the order
Sample Request
curl -X POST \
https://api-sandbox.abnamro.com/v1/tikkie/fastcheckout/orders \
-H 'API-Key: {your_api_key}' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'X-Merchant-Token: {your_merchant_token}' -d '{"referenceId": "some reference",  "shippingCostsInCents": 690,  "discountInCents": 500,  "currency": "EUR",  "expiration": 1800,  "redirectUrl": "https://www.yourdomain.nl/finishorder/1234",  "notificationUrl": "https://www.yourdomain.nl/1234",  "items": [ {"itemName": "Mobile Phone","priceInCents": 50000,  "quantity": 1} ]}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true Unique id generated for every request
checkoutUrl String Body true URL to the checkout page
orderToken String Body true Unique identifier of the order
Sample Response
{
    "checkoutUrl": "https://checkout.sbx.tikkie.me/checkout/346e5cA2-8306-46de-a0ad-a21eaf5177df",
    "orderToken": "696e5ce2-8306-40ee-a0ad-a21eaf5177df"
}

GET Order

GET /v1/tikkie/fastcheckout/orders/{orderToken}

This operation will retrieve an order.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key obtained after app registration on developer portal
X-Merchant-Token String Header true Merchant token created using the /v1/tikkie/fastcheckout/merchant resource
orderToken String Path true Identifier of the order
Sample Request
curl -X GET \
https://api-sandbox.abnamro.com/v1/tikkie/fastcheckout/orders/{your_order_token} \
-H 'API-Key: {your_api_key}' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'X-Merchant-Token: {your_merchant_token}'
Response Attributes
Name Type In Required Description
orderToken String Body true Unique identifier of the order
referenceId String Body true The referenceId used when creating the order
shippingCostsInCents String Body true Total shipping costs of the order
discountInCents String Body false Any discount that should be removed from total cost of the order
currency String Body true Currency of the amounts used
items String Body true Array of all the items from customer's shopping cart
itemName String Body true Name of the item
priceInCents String Body true Price of the item in cents
quantity String Body true Quantity of the item in the order
status String Body true Whether this order is NEW, PAID, CANCELLED, EXPIRED, ERROR
payer String Body true If the order is paid then this field contains information about the payer
companyName String Body false Name of the company, in case of business address
firstName String Body true First name of payer
lastName String Body true Last name of payer
email String Body true Email address of payer
phoneNumber String Body false Phone number of payer
shippingAddress String Body true Shipping Address
street String Body true Street
houseNumber String Body true House Number
addition String Body false Addition
postalCode String Body true Postal Code
city String Body true City
country String Body true Country
Sample Response
{
    "orderToken": "346e5cA2-8306-46de-a0ad-a21eaf5177df",
    "referenceId": "Some reference",
    "shippingCostsInCents": 690,
    "discountInCents": 0,
    "currency": "EUR",
    "items": [
        {
            "itemName": "Mobile",
            "priceInCents": 20000,
            "quantity": 1
        }
    ],
    "status": "PAID",
    "payer": {
        "companyName": null,
        "firstName": "John",
        "lastName": "Doe",
        "email": "johndoe@somedomain.url",
        "phoneNumber": "+31612345678",
        "shippingAddress": {
            "street": "Newstreet",
            "houseNumber": "123",
            "addition": null,
            "postalCode": "1011AB",
            "city": "NEWCITY",
            "country": "NL"
        }
    }
}

Webhook

This is the body that we will send as a POST to the URL that was specified in the field "notificationUrl" in the POST /order

{
    "referenceId": "Some reference",
    "orderToken": "cf06509d-337e-4ecf-8e04-124e8848258f",
    "status": "PAID"
}

Error Response & Codes

This section describes the error response & the codes being sent by Tikkie Fast Checkout API.

Sample Error Response
{
    "errors": [
        {
            "code": "ERR_4100_004",
            "message": "Order not found",
            "reference": "https://developer.abnamro.com",
            "traceId": "aa8115a6-b5e2-43f7-af99-bb8c289462f6",
            "status": 404,
            "category": "NOT_FOUND"
        }
    ]
}
Error Attributes

This section lists the errors that are particular for this API. If your error is not listed here, or you want to know which general errors can occur, please check the general error section.

Code Status Category Description
ERR_1100_004 400 BAD_REQUEST One of the input paramater is invalid
ERR_1100_005 400 BAD_REQUEST A parameter is missing, see the message field of the response to find out which one
ERR_1100_006 400 BAD_REQUEST See the message field of the response for more information
ERR_1100_007 400 BAD_REQUEST This operation was not found
ERR_1100_008 400 BAD_REQUEST Unknown field
ERR_3100_004 400 BAD_REQUEST Merchant Token is missing in header
ERR_3100_005 400 BAD_REQUEST Discount is greater than or equal to total amount
ERR_4100_003 404 NOT_FOUND The user could not be found/does not exist
ERR_4100_004 404 NOT_FOUND Order not found
ERR_4100_005 401 UNAUTHORIZED Merchant token not valid
ERR_8100_001 500 INTERNAL_SERVER_ERROR An unknown error occurred in the backend. Please contact us if this problem persists
ERR_9100_011 503 SERVICE_UNAVAILABLE Tikkie service unavailable