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

Get a Dispute

GET
/disputes/{id}

Get info about a Dispute on the Global Payments system using the unique id created by Global Payments for that Dispute. 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

Unique identifier for the Dispute on the platform.

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/disputes/DIS_SAND_abcd1236" \  -H "X-GP-Version: 2021-03-22"
{  "id": "DIS_SAND_abcd1236",  "merchant_id": "MER_c4c0df11039c48a9b63701adeaa296c3",  "merchant_name": "Sandbox_merchant_2",  "account_id": "TRA_86920f927028745yt34d077d88beb29b",  "account_name": "transaction_processing",  "time_created": "2021-05-03T21:23:39.718Z",  "status": "UNDER_REVIEW",  "status_time_created": "2021-02-22T10:24:43.999Z",  "stage": "RETRIEVAL",  "stage_time_created": "2021-02-22T10:24:43.999Z",  "amount": "11099",  "currency": "USD",  "payer_amount": "1999",  "payer_currency": "USD",  "merchant_amount": "1999",  "merchant_currency": "USD",  "reason_code": "FRAUD",  "reason_description": "string",  "time_to_respond_by": "2025-02-22T10:24:43.761Z",  "result": "PENDING",  "investigator_comment": "string",  "funding_type": "DEBIT",  "deposit_time_created": "2021-02-22T10:24:43.761Z",  "deposit_id": "DEP_128932Y328Y92",  "system": {    "mid": "string",    "tid": "string",    "hierarchy": "string",    "name": "MERCHANT ABC INC",    "dba": "MERCHANT XYZ INC",    "global_transaction_source": "gp-apigee",    "global_transaction_reference": "rrt-6037ed91-07b9-4964-95e9-3c650601e6earpz4n"  },  "last_adjustment_amount": "1999",  "last_adjustment_currency": "USD",  "last_adjustment_funding": "DEBIT",  "last_adjustment_time_created": "2021-02-22T10:24:43.761Z",  "net_financial_amount": "1999",  "net_financial_currency": "USD",  "net_financial_funding": "DEBIT",  "foreign_issued_card": "NO",  "disposition_description": "Response sent to Issuer",  "disposition_date": "2021-02-22T10:24:43.761Z",  "case_time_created": "2021-02-22T10:24:43.761Z",  "store_reference": "6",  "region_code": "NA",  "payment_method_provider": [    {      "comment": "Payer never got the goods",      "reference": "CASE_NO_23423863",      "documents": [        {          "id": "DOC_lskdnfosdfjsdfsdf23dasd",          "b64_content": "R0lGODlhigPCAXAAACwAAAAAigPCAYf///8AQnv=",          "type": "ACQUIRER_DOC_FOR_ISSUER"        }      ]    }  ],  "transaction": {    "time_created": "2021-05-03T21:23:39.718Z",    "type": "SALE",    "amount": "11099",    "currency": "USD",    "reference": "becf9f3e-4d33-459c-8ed2-0c4affc9555e",    "remarks": "MY-TRANS-REMARKS",    "terminal_capability_code": "E00808",    "merchant_category_code": "5999",    "provider": {      "avs_result": "Y"    },    "payment_method": {      "entry_mode_code": "81",      "card": {        "number": "string",        "arn": "string",        "brand": "VISA",        "authcode": "string",        "brand_reference": "string",        "issuer_bin": "123456",        "acquirer_bin": "1234"      }    },    "order": {      "reference": "b636294sd5b6826hjdnde92",      "invoice_number": "1234"    }  },  "documents": [    {      "id": "DOC_lskdnfosdfjsdfsdf23dasd",      "b64_conent": "R0lGODlhigPCAXAAACwAAAAAigPCAYf///8AQnv=",      "type": "ACQUIRER_DOC_FOR_ISSUER"    }  ],  "device": {    "terminal_capacity_code": "1"  },  "action": {    "id": "ACT_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",    "type": "DISPUTE_SINGLE",    "time_created": "2021-05-03T21:23:39.718Z",    "result_code": "SUCCESS",    "app_id": "uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",    "app_name": "my_lovely_app"  }}

List Disputes GET

Get a list of disputes recently processed, using criteria passed in the query string. Page through the result set to access all records. 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.

Accept POST

Accept liability for a Dispute that will likely result in financial impact to the Merchant. 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.