Global Payments API
GP Developer PortalGP API reference
HomeAPI ReferenceSDKsContext Plugin
Transactions

Get a Transaction

GET
/transactions/{id}

Get a single view of a transaction using the transaction id. Availability of this feature in production depends on your allowed live configuration. Please contact Global Payments before coding this feature to confirm it will be available to you when you go live.

Authorization

bearerAuth
AuthorizationBearer <token>

Access token from POST /accesstoken, sent as Authorization: Bearer <token>.

In: header

Path Parameters

id*string

A unique identifier that is used to identify and reference an instance of this resource. It is generated by Global Payments to identify the transaction and must be used to action that transaction in future.

Length1 <= length <= 50

Header Parameters

X-GP-Version*string

The version of the API to execute the request.

Length1 <= length <= 50
Default"2021-03-22"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/transactions/TRN_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d" \  -H "X-GP-Version: 2021-03-22"
{  "id": "TRN_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",  "time_created": "2026-05-03T21:23:39.718Z",  "time_last_updated": "2026-05-03T21:23:39.718Z",  "status": "CAPTURED",  "type": "SALE",  "merchant_id": "MER_A6A1EC44522F96630ABEA17A",  "merchant_name": "ABC INDUSTRIES",  "account_id": "TRA_86920f927028745yt34d077d88beb29b",  "account_name": "transaction_processing",  "channel": "CP",  "reference": "becf9f3e-4d33-459c-8ed2-0c4affc9555e",  "amount": "11099",  "currency": "USD",  "description": "SKU#BLK-MED-G123-GUC",  "order_reference": "INV#88547",  "batch_id": "BAT_234234234",  "initiator": "PAYER",  "country": "US",  "language": "fr_CA",  "ip_address": "string",  "site_reference": "string",  "parent_resource_id": "TRN_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",  "create_action_id": "ACT_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",  "order": {    "reference": "INV#88547",    "shipping_amount": "100",    "duty_amount": "1000",    "taxes": [      {        "type": "VAT",        "amount": "string",        "percentage": "1"      }    ]  },  "payer": {    "id": "PYR_oOAH6BClraQWS3Qy07dh7tZAN3X2nW"  },  "payment_method": {    "name": "JANE DOE",    "result": "string",    "message": "string",    "entry_mode": "ECOM",    "card": {      "brand": "VISA",      "authcode": "string",      "brand_reference": "string",      "masked_number_first6last4": "426397xxxxxx5262",      "masked_number_last4": "xxxxxxxxxxxx5262",      "funding": "CREDIT",      "issuer": "string",      "country": "US",      "currency": "USD",      "cvv_indicator": "PRESENT",      "cvv_result": "MATCHED",      "avs_address_result": "MATCHED",      "avs_postal_code_result": "MATCHED",      "masked_network_token_last4": "stri"    },    "digital_wallet": {      "token": "string",      "token_format": "CARD_NUMBER",      "cryptogram": "string",      "provider": "GOOGLE_PAY",      "masked_number_last4": "xxxxxxxxxxxx5262",      "masked_number_first6last4": "426397xxxxxx5262",      "masked_token_first6last4": "426397xxxxxx5262",      "expiry_month": "12",      "expiry_year": "29",      "eci": "strin",      "cvv": "852",      "cvv_indicator": "PRESENT",      "avs_address": "string",      "avs_postal_code": "string",      "payment_account_reference": "string"    },    "authentication": {      "id": "AUT_6a061b51-6e7a-4200-9d8c-01be5e26a5bb",      "three_ds": {        "status": "AUTHENTICATION_SUCCESSFUL",        "message_version": "string",        "eci": "strin",        "value": "string",        "cavv_result": "string",        "server_trans_ref": "string",        "ds_trans_ref": "string",        "exempt_status": "LOW_VALUE"      }    },    "bnpl": {      "provider": "KLARNA"    }  },  "installment": {    "program": "VIS",    "mode": "NO_INTEREST",    "count": "99",    "grace_period_count": "30"  },  "link": {    "id": "LNK_bnqlo0LgbMt221TczxF70Awdg7c5ez"  },  "system": {    "mid": "string",    "tid": "string",    "hierarchy": "string",    "name": "string",    "dba": "string"  },  "action": {    "id": "ACT_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",    "type": "AUTHORIZE",    "time_created": "2026-05-03T21:23:39.718Z",    "result_code": "SUCCESS",    "app_id": "uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",    "app_name": "my_lovely_app"  }}

Create a Sale or Refund POST

Create a Sale or Refund transaction that attempts to transfer funds between the Payer and the Merchant using a specific Payment Method. The Sale transaction can be flagged for automatic capture (default) or flagged as requiring a separate capture action later. Availability of refunds that do not link directly to a previous Sale transaction depends on your live configuration.

Refund a Sale POST

Create a Refund transaction from a previous Sale. The payment method associated with the original Sale is used to refund the Payer. If the amount is not specified in the refund request, the full amount of the Sale will be refunded. Availability of this feature in production depends on your allowed live configuration. Please contact Global Payments before coding this feature to confirm it will be available to you when you go live.