This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

Getting Information About a Specific Payment

Send a GET request to the /payments/{guid} endpoint of the orders API to obtain detailed information about a specific payment. The endpoint returns a Payment object that contains information about the payment. For information about the values of the Payment object, see the reference documentation for the orders API.

The following example curl command sends a GET request to the /payments/{guid} endpoint for a specific payment.

Get Information of a Specific Payment

curl -X GET \ -H "Authorization: Bearer
      eyJzI1NiJ9hbGciOiJSU.eyJhd9yaXR5Ij
      oiQ1JVTkNIVElNRSIsInJzR3VpZCI6IjE4YzQ5YWJlLWFlODItNGFlYy04ND
      M1LWJhYTRjMjVlYTY2MiIsInNjb3BlIjpbImxWQiOlsidG9hc3QiXSwibmFt
      aW5nQXV0aGhYm9yIiwib3JkZXJzIiwidXNlcm1nbXQiXSwiZXhwIjoxNDg0M
      zg5ODUwLCJqdGkiOiJlMDYzZjJkMy1jNGYyLTRiZjItODJmNi01MTg1NWMzZ
      DAxM2YiLCJjbGllbnRfaWQiOiJjcnVuY2h0aW1lIn0.X1_0y9Hzj5F9gdOw2
      o6VSYTyZwooAJiFMDmNakbZrtiUdYwLzuLwLpCMQzX5pKYtOqDUz_cetGJL3
      txKL1L-K2j1Enoq8An8hEM6e8J0KdAiwrYFO3W3CmWedaoz95K9ghNZVCs28
      Td2Sp3Ix3fObxbrvanocx9_OT8S9uM8hdSXmBI_ykTWvOVgK4hO24V3DJy4b
      9bz1FtgOvrClhELxCe8dJy7jiwAR60xczlCF5rna98RMLN6zY4ffjmljKFZ6
      QV0KkVppWjEiJn7oFHiIylCX1sSg7sddrGatj0xJzts3GJ8u8_lryUNHaEvJ
      dWq4Yzwo007AMgxjH9d241Y-g" \ -H "Toast-Restaurant-External-ID:
      76cb1b05-cb1e-4adf-863a-b2a94a5ecdcf" \1
      https://[toast-api-hostname]/orders/v2/payments/361d140a-aa0b-43ad-98d6-516c416555d92

1

Use the Toast-Restaurant-External-ID request parameter to specify the GUID of the restaurant in which the payment was made.

2

Specify the payment GUID, which you can get from the /payments endpoint of the orders API.


The following example shows the JSON response data for a GET request to the /payments/{guid} endpoint. The payment method for this sample payment was a credit card.

Get Payment Return Data

{
  "guid": "361d140a-aa0b-43ad-98d6-516c416555d9",1
  "entityType": "OrderPayment",
  "externalId": null,
  "originalProcessingFee": null,
  "amount": 57.73,2
  "tipAmount": 0,3
  "amountTendered": 0,
  "cashDrawer": null,
  "cardType": "VISA",
  "lastModifiedDevice": {
    "id": "7c664bbbb33913bd"
  },
  "refundStatus": "NONE",
  "houseAccount": null,4
  "type": "CREDIT",5
  "voidInfo": null,6
  "otherPayment": null,7
  "mcaRepaymentAmount": null,
  "createdDevice": {
    "id": "7c664bbbb33913bd"
  },
  "paidDate": "2020-02-11T16:38:32.774+0000",8
  "cardEntryMode": "KEYED",9
  "paymentStatus": "CAPTURED",10
  "paidBusinessDate": 20200211,
  "last4Digits": "1111",
  "refund": null,11
  "orderGuid": "86675d88-b27e-4850-94ab-48662563eae8",
  "checkGuid": "ed4b222f-5259-43fd-8db0-1243a11ed554"
}

1

The guid value contains the unique Toast POS identifier of the payment.

2

The amount of the payment, including taxes and service charges but excluding tips.

3

The amount tipped on this payment.

4

If a house account was used to pay the check, this value contains reference information (such as the GUID) of the house account. The value is null if a house account was not used for payment.

5

The payment method, such as CREDIT for a credit card.

6

If the payment was voided, this value contains a VoidInformation object with information about the void. For details, see Voided Payments. The value is null if the payment has not been voided.

7

Reference information (such as the GUID) of an other payment option used to pay the check. The value is null if an other payment option was not used for payment.

8

The date and time when the payment was made.

9

For credit card payments, specifies how the credit card data was obtained. The value is null if a credit card was not used for payment.

10

The status of the payment. In this example, the payment has been captured.

11

If the payment has been refunded, this value contains a Refund object with information about the refund. For details, see Refunded Payments. The value is null if the payment has not been refunded.


The following sections provide information about voided and refunded payments.