Skip to content
Global Payments Oceania API Global Payments Oceania API

In Person Payment Flow

The payment flow for an in-person payment differs to an online checkout, as the card details are collected directly by your physical terminal device. The flow can be broken down into 4 steps.

Step 1: Create a transaction request from your POS software by posting to the /transactions/terminals endpoint. This will push a tender from Global Payments to your terminal to initate the collection of card details.

Step 2: The customer will tap/insert/swipe their card against the terminal.

Step 3: The terminal submits the payment to the banking network to process.

Step 4: Global Payments triggers a webhook back to your software, containing the transaction results and the EFTPOS receipt.

The following sequence diagram was designed to help visualise the workflows in place when processing an in-person payment via a terminal.

sequenceDiagram
    
    actor Customer
    participant Terminal Device
    
    
    Customer->>Merchant: Present items for purchase
    activate Customer

    activate Merchant
    Merchant->>POS Software: Scan in items
    
    activate POS Software
    POS Software->>Global Payments: Submit request to <br>/transactions/terminals
    activate Global Payments
    
    Global Payments->>Terminal Device: Push tender to device
    

    activate Terminal Device
    Terminal Device-->>Customer: Show message to <br>present card
    Customer->>Terminal Device: Tap or insert card
    Terminal Device->>Global Payments: Submit card details for processing
    deactivate Terminal Device

    Global Payments->>Banking Network: Process the payment
    activate Banking Network
    Banking Network ->> Global Payments: Provide transaction response
    deactivate Banking Network

    Global Payments ->> POS Software: Send response or webhook <br>with transaction results
    deactivate Global Payments

    POS Software ->> Merchant: Display result and prints Eftpos receipt
    deactivate POS Software

    Merchant ->> Customer: Hand over purchased items and receipt
    deactivate Merchant
    deactivate Customer