Transaction - POST

Helps you create, get and delete transactions.

The transaction request is divided into two parts to eliminate complete syncing errors. POST: the initial transaction setup and send, and PUT: Flag as complete with final send.

This POST generates the transaction ID, which can then be used for updates and also to attach transactions. It is always the first thing that must be done.

The endpoint you need to use for this is:

/transaction

Request

Headers

Key Details Example
Authorization* {token_type} {access_token} Bearer c3499c2729730a7f807efb8676a92dcb6f8a3f8f
Method* POST N/A
x-accept-version {recommended_latest_version_number} 2

* Required header

Body

NOTE: To update just supply the object id.

Key Details Data Type
transactions[{transactionId}].basketId unique basket Id Int
transactions[{transactionId}].type Type (See types below for more info) String
transactions[{transactionId}].amount Amount (in pence) Int
transactions[{transactionId}].tip Tip (in pence) Int
transactions[{transactionId}].Note Transaction Notes String

                                                

Response

Headers

Key Details Data Type Example
statusCode Very important to check this for any error. 201 for success. int 201

Body

Key Details Data Type
transactions[{transactionId}].basketId unique basket Id Int
transactions[{transactionId}].type Type (See types below for more info) String
transactions[{transactionId}].amount Amount (in pence) Int
transactions[{transactionId}].tip Tip (in pence) Int
transactions[{transactionId}].completeDate Complete Date Date
transactions[{transactionId}].id Transaction ID Int
transactions[{transactionId}].Note Transaction Note String

                                                

Attribute Options

Type

ID Value
CASH CASH Payment
CARD CARD Payment
CHEQUE CHEQUE Payment
VOUCHER VOUCHER Payment
APP APP Payment

Status Codes

Error

Please check the live API calls for more details on the API messages.

ID Status Code Title Details
908 401 Expired Token Token expired or invalid. Please renew your token
911 401 Authorization Header Invalid The authorization header is invalid. The correct format is Authorization: {token_type} {accessToken}
919 429 Cannot handle too many request There is a limit for every object you can send to our server and you are exceding that.
913 400 Required parameter or object missing in request One or more of the required parameters or object formation is missing in your request. Please refer the documentation
904 401 Access Denied Access denied for the request
912 403 Resource Not Allowed For Specified User The user does not own this resource and its forbidden
899 500 Unknown Error Something went wrong. Please contact the site administrator

Success

Please check the live API calls for more details on the API messages.

ID Status Code Title Details
202 200 Token is valid Token is validated and found valid.
206 201 Resource Created Your resource is created partially or fully. Please check further message or process log
preloader