Last updated 3 minutes ago

Getting Started Terminal Connect

Agenda

  1. High-level data flow
    • Data flow of how a payment is made.
  2. Making a payment
    • Step-by-step process to make a payment transaction.
  3. Integration process
    • End-to-end process on integrating with Till.

High-level data flow

POSTill PaymentsTill TerminalCustomerPOS Creates an intention for a transaction1POS Gets an intention ID.2POS Process the intention to the terminal3Till Sends the intention to the Terminal4Customer presents card5Provide Results6Till Posts the results7POSTill PaymentsTill TerminalCustomer

Making your First Payment

Pre-requisites

Things you will need to go through this getting started tutorial

  1. A Till Payments Sandbox account
  2. Access to the Terminal Connect Android Application
  3. Testing credentials that will be provided once a sandbox account is provisioned

Step 1: Get a list of terminals

Let's create a API request to get a list of terminals that will be used later in the process to send an Intent too.

Requirements

This API request will require

  • Merchant Id (also referenced as mid).
  • A valid API key assosicated to the mid.
Loading...

Step 2: Create a Payment Intent

We need to create a Payment intent which will contain the subTotal for the terminal.

Loading...

Step 3: Send to a Terminal to process

Once the intent is created, we can send it to a terminal to process. The terminal will then present a card to the customer to complete the transaction.

Please complete Step 2 first. We need the intentId (step2.response.body.intentId) from the response body in Step 2 for this request. This ID tells the API what intent to send to a device for processing.

Step 4: Get the results of the intent

After a card payment transaction is completed with the terminal, the POS will receive the results of the transaction using the post back URL (URL is provided when creating the payment intention).

Congratulations!

If you've made it this far and completed the steps above, you have successfully made your first payment using Till Payments Terminal Connect.