Create a Payer
Create a Payer on the Global Payments system that can be used when creating a sale.
Authorization
bearerAuth Access token from POST /accesstoken, sent as Authorization: Bearer <token>.
In: header
Header Parameters
The version of the API to execute the request.
1 <= length <= 50"2021-03-22"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.
1 <= length <= 50Request Body
application/json
The first name of the Payer
1 <= length <= 50The last name of the Payer
1 <= length <= 50This is a label set by the integrator to identify the Payer
1 <= length <= 50The email address of the payer.
The preferred language of the payer. In the format ISO-639-1 (alpha-2) or ISO-639-1 (alpha-2)_ISO-3166(alpha-2)
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/payers" \ -H "X-GP-Version: 2021-03-22" \ -H "Content-Type: application/json" \ -d '{ "first_name": "John", "last_name": "James", "reference": "payer-123", "payment_methods": [ { "id": "PMT_oOAH6BClraQWS3Qy07dh7tZAN3X2nW", "default": "YES" } ] }'{ "id": "PYR_2ee5480308664428bef46d1094f22adc", "time_created": "2025-08-11T11:39:03.000Z", "time_last_updated": "2025-08-11T11:39:03.000Z", "first_name": "JXXXXXX", "last_name": "MXXXXXXX", "reference": "Testing_Payer_Encrypted", "merchant_id": "MER_c5d37eaf0e3841e083c232b2318af55c", "merchant_name": "Sandbox_Merchant_4", "account_id": "TKA_c1de85a8a5844c56abd9ca07bbd792c8", "account_name": "tokenization", "action": { "id": "ACT_YiMFP1AyT8984XMkfKdVvEv1IxbkSp", "type": "PAYER_CREATE", "time_created": "2025-08-11T11:39:03.194Z", "result_code": "SUCCESS", "app_id": "T6og1tbECpHFeO104qUM383oq5bOJ12r", "app_name": "Postman_Collection_Test" }}