Accounts

Edit a Merchant's Account info

PATCH
/accounts/{id}

Edit merchant's account configuration.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

This is the account id created to uniquely identify it in the Global Payments system.

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"
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

Request Body

application/json

payer?
card_replacement_reason?"LOST"

Indicates the reason why a Prepaied card needs to be replaced.

  • LOST - The card has either been lost or stolen. This will immediately disable the currently-assigned card and issue a new card with a new number. The card PIN number will be mailed to the account's shipping address.

Value in

  • "LOST"
notifications?

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Callbacks

curl -X PATCH "https://example.com/accounts/string" \  -H "X-GP-Version: 2021-03-22" \  -H "Content-Type: application/json" \  -d '{    "payer": {      "payment_method": {        "name": "name",        "reference": "123456",        "card": {          "number": "4747474747474747",          "expiry_month": "02",          "expiry_year": "22",          "cvv": "999"        }      },      "billing_address": {        "line_1": "Address 1",        "line_2": "",        "city": "Atlanta",        "state": "Georgia",        "postal_code": "30346",        "country": "USA"      }    }  }'
Empty