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

Obtain Result

GET
/authentications/{id}/result

Obtain the authentication information that must be submitted when creating a transaction to achieve the fraud liability shift from 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.

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 authentication and must be used to action or reference that authentication.

Length1 <= length <= 50

Header Parameters

X-GP-Idempotency?string

Integrator generated value submitted in the request header that is checked to ensure the same value has not been seen in the last 24 hours. It is used to ensure idempotency is maintained with this action.

Length1 <= length <= 50
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/authentications/AUT_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d/result" \  -H "X-GP-Version: 2021-03-22"
{  "id": "AUT_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",  "time_created": "2021-05-03T21:23:39.718Z",  "status": "AVAILABLE",  "channel": "CP",  "amount": "11099",  "currency": "USD",  "country": "US",  "source": "BROWSER",  "three_ds": {    "acs_trans_ref": "string",    "ds_trans_ref": "strin",    "server_trans_ref": "string",    "acs_reference_number": "string",    "liability_shift": "YES",    "authentication_type": "STATIC_CHALLENGE",    "authentication_value": "string",    "eci": "strin",    "status": "AUTHENTICATION_SUCCESSFUL",    "status_reason": "HIGH_CONFIDENCE",    "redirect_url": "string",    "acs_challenge_request_url": "string",    "authentication_request_type": "PAYMENT_TRANSACTION",    "acs_decoupled_response_indicator": [      "DECOUPLED_AUTHENTICATION_UTILISED"    ],    "whitelist_status": "WHITELISTED_BY_CARDHOLDER",    "message_extension": [      "string"    ]  },  "notifications": {    "challenge_return_url": "string"  },  "action": {    "id": "ACT_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",    "type": "CHECK_AVAILABILITY",    "time_created": "2021-05-03T21:23:39.718Z",    "result_code": "SUCCESS",    "app_id": "uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",    "app_name": "my_lovely_app"  }}

Initiate POST

For 3DS 2, submit data including the billing and shipping details of the payer, at least one phone number, the device data, transaction details, outcome from the ACS Method URL if it took place and a link to the merchant's About or Contact page. 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. The `Challenge_Return_Notification` callback is sent to the URL supplied in an earlier request ({$request.body#/notifications/challenge_return_url}); see POST /authentications.

Get Single Authentication GET

Return a single Authentication Response. 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.