Void
Send a request to display a void on a PAX POS device.
uti
An id provided by the POS in a sale response. Used for message matching in a re-print.
amount
The amount represented with two minor units, e.g. 12 EUR is 1200.
disablePrinting
Indicates if to print a receipt.
referenceId
Optional reference from merchants.
language
The language that the PAX POS will use to display information on the device. One of the following:
en_GB
ar_EG
da_DK
de_DE
es_ES
fi_FI
hi_IN
is_IS
nb_NO
nl_NL
pi_PL
pt_PT
ru_RU
sl_SI
sv_SE
zh_CN
voucherCode
A Mastercard voucher code is a unique alphanumeric code that can be used to redeem a specific value or discount on purchases made with a Mastercard, typically provided as part of a promotion or reward program.
whitelistAids
Specify the AIDs that are allowed to be used in the transaction, terminal config needs a predefined list of AIDs to be able to use this feature.
whitelistBins
Specify the BINs that are allowed to be used in the transaction. Terminal config needs a predefined list of BINs to be able to use this feature.
callbackUrl
The URL that CloudLinkApi will use to return information to the caller.
deviceToken
The token of a PAX POS device.
correlationId
An ID provided by the caller. Returned in the callback for message matching. In a cancel request, use the value from the sale/refund that is being canceled.
timeToLive
The token of a PAX POS device.
endStateApplication
Deprecated - Do not use. End state application is the name of the application that is supposed to be active on the pos device once the transaction has been processed.
type
Example: https://tools.ietf.org/html/rfc7231#section-6.5.1
title
One or more validation errors occurred.
status
400
errors
Object with one or more errors. Example: "The Uti field is required."
message
Unauthorized
message
Server Error
/void
202 Void Accepted
curl -X post https://CloudLinkApi/void -H 'X-API-KEY: your-access-key-here' -d ' { "uti": "83EF00C9-8A86-4E84-8E05-35B7B4358566", "amount": "100", "disablePrinting": true, "referenceId": "merchant-ref-number-abc123", "language": "en_GB", "voucherCode": null, "whitelistAids": null, "whitelistBins": null, "callbackUrl": "http://example.com/webhook-endpoint", "deviceToken": "b16526c3447ba6cea4818d", "correlationId": "5d1d4ea-8229-44d7-b517-26a5ae6c2fda", "timeToLive": 5, "endStateApplication": null } '{ message: "Accepted" }
400 Bad Request
curl -X post https://CloudLinkApi/void -H 'X-API-KEY: your-access-key-here' -d ' { "uti": "83EF00C9-8A86-4E84-8E05-35B7B4358566", "amount": "100", "disablePrinting": true, "referenceId": "merchant-ref-number-abc123", "language": "en_GB", "voucherCode": null, "whitelistAids": null, "whitelistBins": null, "callbackUrl": "http://example.com/webhook-endpoint", "deviceToken": "b16526c3447ba6cea4818d", "correlationId": "5d1d4ea-8229-44d7-b517-26a5ae6c2fda", "timeToLive": 5, "endStateApplication": null } '{ "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1", "title": "One or more validation errors occurred.", "status": 400, "errors": { "Uti": [ "The Uti field is required." ] } }
401 Unauthorized
curl -X post https://CloudLinkApi/void -H 'X-API-KEY: your-access-key-here' -d ' { "uti": "83EF00C9-8A86-4E84-8E05-35B7B4358566", "amount": "100", "disablePrinting": true, "referenceId": "merchant-ref-number-abc123", "language": "en_GB", "voucherCode": null, "whitelistAids": null, "whitelistBins": null, "callbackUrl": "http://example.com/webhook-endpoint", "deviceToken": "b16526c3447ba6cea4818d", "correlationId": "5d1d4ea-8229-44d7-b517-26a5ae6c2fda", "timeToLive": 5, "endStateApplication": null } '{ "message": "Unauthorized" }
500 Server Error
curl -X post https://CloudLinkApi/void -H 'X-API-KEY: your-access-key-here' -d ' { "uti": "83EF00C9-8A86-4E84-8E05-35B7B4358566", "amount": "100", "disablePrinting": true, "referenceId": "merchant-ref-number-abc123", "language": "en_GB", "voucherCode": null, "whitelistAids": null, "whitelistBins": null, "callbackUrl": "http://example.com/webhook-endpoint", "deviceToken": "b16526c3447ba6cea4818d", "correlationId": "5d1d4ea-8229-44d7-b517-26a5ae6c2fda", "timeToLive": 5, "endStateApplication": null } '{ "message": "Server Error" }