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

Get a Fund

GET
/merchants/{id}/funds/{FND_id}

Get info about a Funding event on the Global Payments system using the unique id created by Global Payments for that Fund.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

A unique identifier for the merchant set by Global Payments.

Length1 <= length <= 50
Default"MER_880c34767b184d5e82b10e767201e648"
FND_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"
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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/merchants/MER_880c34767b184d5e82b10e767201e648/funds/FND_ZkGPrJiuVRMCh10VEyInhn0fbTKdfT" \  -H "X-GP-Version: 2021-03-22"
{  "id": "FND_ZkGPrJiuVRMCh10VEyInhn0fbTKdfT",  "time_created": "2023-03-10T13:14:48.386Z",  "time_last_updated": "2023-03-10T13:14:48.386Z",  "type": "DEBIT",  "status": "CAPTURED",  "amount": "100",  "currency": "USD",  "payment_method": "BANK_TRANSFER",  "merchant_id": "MER_880c34767b184d5e82b10e767201e648",  "merchant_name": "Curtis_Douglas49",  "account_id": "FMA_bde109d70fb24d78b25fd364317dd9dc",  "account_name": "718556837_989567",  "provider": {    "result": "00",    "message": "Successful"  },  "action_create_id": "ACT_tec6AQFrGKEeFY1BLFDA3cz3wSG69u",  "parent_resource_id": "FND_zeSDfZ9OfM8IWgInQXImc8azdqE2es",  "action": {    "id": "ACT_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",    "type": "FUNDS",    "time_created": "2021-05-03T21:23:39.718Z",    "result_code": "SUCCESS",    "app_id": "uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",    "app_name": "my_lovely_app"  }}

Credit Or Debit a Funds Management Account (FMA) POST

Used to deposit funds to a connected business bank account or debit card. Can also be used to add funds to a Global Payments Funds Management Account (FMA) from a connected business bank account. The `Bank_Transfer_Return_Notification` callback is sent to the URL supplied in an earlier request ({$request.body#/notifications/status_url}); see POST /authentications.

List Funds GET

Get a list of Funds recently processed, using criteria passed in the query string. Page through the result set to access all records.