• Home
  • Our APIs
  • Guides
  • Our Products
    • Nothing Found
  • Home
  • Our APIs
  • Guides
  • Our Products
    • Nothing Found
    v1.0
    Introduction
    Authentication
    Currency
    Terminals
    Intent
      get
      Get intent by ID
      post
      Create payment intent
      post
      Create Pre-Auth create intent
      post
      Create Pre-Auth capture intent
      post
      Create a Pre-Auth cancel intent
      post
      Create refund intent
      post
      Create reversal intent
      post
      Create NFT intents
      post
      Cancel an intent being processed
      post
      Request a terminal to process an intent

Create Pre-Auth capture intent

Create a Pre-Authorisation capture intent to be sent to a device at a later date.

Securityapi_key
Request
path Parameters
mid
required
string

Merchant Identifier.

Request Body schema: application/json
subTotal
required
number

Currency is in a no-decimal format. For decimal based currencies, when converting to a decimal based format place a decimal before the last two digits.

tip
number
tax
number
merchantReference
string

A field where you can provide your own reference to send to the host

postbackUrl
string <uri>

When a terminal has finished processing a transaction it will send a callback to the url defined here.

parentIntentId
required
string <uuid>

The Parent preauth intentId

Responses
201
400

Bad payload.

401

Invalid API key/MID.

403

Forbidden from performing this action.

500
post/merchant/{mid}/intent/preauth/capture
Request samples
  • Payload
application/json
{
  • "subTotal": 100,
  • "tip": 50,
  • "tax": 10,
  • "merchantReference": "sale-10-10-2022",
  • "postbackUrl": "https://<your-domain>.com/postback",
  • "parentIntentId": "977e752c-43c3-4242-980f-81d18ca08185"
}
Response samples
  • 201
  • 400
  • 401
  • 403
  • 500
application/json
{
  • "intentId": "uuid-uuid-uuid-uuid"
}
Legal
  • Privacy Policy
Support
  • Contact us
© Copyright Till Payments 2023. All right reserved.