Getting a payment intent

To get the details of or to check on the status of a payment intent, send a GET request to the /v1/payment-intents/{id} endpoint of the payment intents API. In the event that the payment intent failed to be successfully confirmed and the status is PROCESSING, this indicates a slow authorization. Slow authorization is a payment failure scenario that occurs when the transaction takes longer than expected to be approved by the bank.

You can choose to continue waiting for the authorization or you can send a request to cancel the payment.

Include the paymentIntentId in the request path. Include the Toast-Restaurant-External-ID as a header parameter.

Example response body

{
   "id":"0ed07dde-311a-4d9a-8e42-1570049137b6", 
   "externalReferenceId":"872af51b-16a2-4a3d-a1da-a7526940fc7f", 
   "sessionSecret":"PI_0ed07dde311a4d9a8e421570049137b6_SECRET_1234abw125", 
   "amount":"1000", 
   "currency":"USD",
   "captureMethod" : "MANUAL",
   "status":"REQUIRES_CAPTURE", 
   "paymentMethodId": null,
   "paymentMethodData": null,
   "creationDate": "2026-07-14T09:35:33.564985467Z",
   "setupFutureUsage": null,
   "customerId": null,
   "amountDetails": {
      "tip": 0,
      "surcharge": null,
      "lineItemModifiers": null,
      "tax": null
   },
    "email": null,
    "paymentMethodConfigurationDetails": {
        "id": null
    },
    "standingInstructionType": null,
    "offSession": false,
    "latestPayment": null,
    "mandateId": null,
    "statementDescriptor": null,
    "statementDescriptorSuffix": null,
    "transferData": null,
    "accountId": null,
    "default": null,
    "cancellationReason": null,
    "cancellationDate": null,
    "paymentMethodOptions": null,
    "lastPaymentError": null,
    "refund": null,
    "order": {
        "id": null, 
        "checkId": "a72af51b-16a2-4a3d-a1da-a7526940fc7f", 
        "paymentId": "16c0ad95-2547-41dc-94b3-a731eb19a141" 
    }
}