Transactions

Sale

This API endpoint enables you to charge a credit card via a terminal by sending a sale command to a terminal. The final approval/decline result is delivered asynchronously to the callbackURL. Terminal connectivity gate: the request returns immediately; before dispatching, the endpoint verifies the terminal is connected to Payarc Connect and, if it is not, responds immediately with 409 TERMINAL_OFFLINE without sending any command to the terminal.

post/v3/transactions/sale

Request

Base URL
https://testpayarcconnectapi.payarc.net
URL
https://testpayarcconnectapi.payarc.net/v3/transactions/sale
Auth
HTTP bearer

Headers

Authorizationstring required

Bearer token used to authenticate API requests.

X-Idempotency-Keystring uuid required

Unique key used to prevent duplicate transaction commands.

Request body

tenantIdstring required

12-digit merchant identifier (MID).

terminalIdstring required

10-digit terminal serial number.

transactionIdstring required

Client-generated transaction identifier used for reconciliation.

tenderType'CREDIT' | 'DEBIT' | 'EBT' required

Tender type used on the transaction.

tipRequestFlagboolean nullable

Whether a tip is requested

tokenizeCardboolean nullable

Determines whether or not the terminal should tokenize the card for the given transaction.

printReceipt0 | 1 | 2 | 3 required

Allowed values: <br> 0 – No receipt<br> 1 – Print merchant receipt<br> 2 – Print customer receipt<br> 3 – Print both merchant and customer receipts

callbackURLstring required

HTTPS endpoint that receives the asynchronous callback payload.

metadataobject

Optional key-value metadata used for correlation and diagnostics.

Example request

{
  "tenantId": "145504363463",
  "terminalId": "1850401309",
  "transactionId": "3fa85f645717",
  "amount": {
    "total": 549,
    "subtotal": 450,
    "currency": "USD",
    "tip": 72,
    "tax": 27
  },
  "callbackURL": "https://example.com/payarc/callback",
  "splits": [
    {
      "mid": "0709900000098856",
      "amount": 100,
      "percent": 55
    }
  ]
}

Response

Transaction Initiated

traceIdstring uuid

Correlation identifier matching the initial API response traceId

Example response

{
  "response": {
    "status": "SUCCESS"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.