Partner APIs: MCA
MCA Demo Funding Ingestion
Simulates an inbound funding event for MCA testing. Works in non-production environments only; in production it returns 400. A 200 means the simulated funding was created; the MCA_FUND_RECEIVED webhook follows asynchronously.
POST
/
gcc
/
v1
/
ffms
/
transaction
/
demo-funding
/
{transactingMid}
/
mca-ingestion
MCA Demo Funding Ingestion
curl --request POST \
--url https://gcc.uat.payglocal.in/gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion \
--header 'Content-Type: application/json' \
--header 'x-gl-auth: <api-key>' \
--data '
{
"currency": "USD",
"amount": "1",
"senderCountry": "US",
"senderName": "test"
}
'import requests
url = "https://gcc.uat.payglocal.in/gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion"
payload = {
"currency": "USD",
"amount": "1",
"senderCountry": "US",
"senderName": "test"
}
headers = {
"x-gl-auth": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.post("https://gcc.uat.payglocal.in/gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion")
.header("x-gl-auth", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"currency\": \"USD\",\n \"amount\": \"1\",\n \"senderCountry\": \"US\",\n \"senderName\": \"test\"\n}")
.asString();const url = 'https://gcc.uat.payglocal.in/gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion';
const options = {
method: 'POST',
headers: {'x-gl-auth': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({currency: 'USD', amount: '1', senderCountry: 'US', senderName: 'test'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"gid": null,
"status": "200 OK",
"message": "demo funding transaction created",
"timestamp": "01/01/2026 00:00:00",
"reasonCode": "GL-201-001",
"data": {
"fundingTransaction": {
"transactionId": "00000000-0000-0000-0000-000000000000",
"status": "pending",
"rawResponse": {
"id": "0000123-0000-0000-0000-000000000123",
"state": "pending",
"amount": "10.00",
"currency": "CAD",
"action": "approve",
"account_id": "11111111-1111-1111-1111-111111111111",
"sender_name": "Jane Doe",
"sender_address": null,
"sender_country": "AE",
"sender_reference": null,
"sender_account_number": "0000000000012",
"sender_routing_code": null,
"receiver_account_number": "000000012",
"receiver_routing_code": null,
"short_reference": "IF-20260101-ABCDEF",
"created_at": "2026-01-01T00:00:00+00:00",
"updated_at": "2026-01-01T00:00:00+00:00"
}
}
},
"errors": null
}When to Use
Use this endpoint in the sandbox to simulate an inbound funding event for atransactingMid, so you can test your webhook handling and document upload end to end without sending real money.
This endpoint works only in non-production environments. In production it returns
400 (Mocking transaction is not allowed in this environment).Authentication
Send your API key in thex-gl-auth header. No x-gl-digest is needed for this endpoint.
x-gl-auth: <your API key>
https://gcc.uat.payglocal.in.
Request Rules
| Field | Rule |
|---|---|
amount | Required. |
currency | Required. EUR, AUD and GBP are simulated through one banking partner and all other currencies through another. |
senderName | Required. |
senderCountry | Required for every currency except EUR, AUD and GBP. |
debtorAccountNumber, debtorFinancialInstitutionCode, debtorIban, paymentScheme | Optional. Sandbox defaults are used when omitted. |
What Happens Next
The200 response means the simulated funding was created, not that it has landed. The funding arrives asynchronously from the sandbox, usually shortly after. When it does, you receive the normal MCA_FUND_RECEIVED webhook with status DOCUMENT_PENDING, and you continue with Upload Document via Presigned URL.
Use the response transactionId only as a reference for the simulation. The gid you use for uploads comes from the webhook.
Error Scenarios
| Scenario | HTTP Code |
|---|---|
Required field missing (amount, currency, senderName, or senderCountry where required) | 400 |
| Called in production | 400 |
x-gl-auth missing or invalid | 401 |
transactingMid does not belong to your partner account | 403 |
| Internal server error | 500 |
Authorizations
Body
application/json
Response
200 - application/json
Demo funding transaction created.
MCA Demo Funding Ingestion
curl --request POST \
--url https://gcc.uat.payglocal.in/gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion \
--header 'Content-Type: application/json' \
--header 'x-gl-auth: <api-key>' \
--data '
{
"currency": "USD",
"amount": "1",
"senderCountry": "US",
"senderName": "test"
}
'import requests
url = "https://gcc.uat.payglocal.in/gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion"
payload = {
"currency": "USD",
"amount": "1",
"senderCountry": "US",
"senderName": "test"
}
headers = {
"x-gl-auth": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.post("https://gcc.uat.payglocal.in/gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion")
.header("x-gl-auth", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"currency\": \"USD\",\n \"amount\": \"1\",\n \"senderCountry\": \"US\",\n \"senderName\": \"test\"\n}")
.asString();const url = 'https://gcc.uat.payglocal.in/gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion';
const options = {
method: 'POST',
headers: {'x-gl-auth': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({currency: 'USD', amount: '1', senderCountry: 'US', senderName: 'test'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"gid": null,
"status": "200 OK",
"message": "demo funding transaction created",
"timestamp": "01/01/2026 00:00:00",
"reasonCode": "GL-201-001",
"data": {
"fundingTransaction": {
"transactionId": "00000000-0000-0000-0000-000000000000",
"status": "pending",
"rawResponse": {
"id": "0000123-0000-0000-0000-000000000123",
"state": "pending",
"amount": "10.00",
"currency": "CAD",
"action": "approve",
"account_id": "11111111-1111-1111-1111-111111111111",
"sender_name": "Jane Doe",
"sender_address": null,
"sender_country": "AE",
"sender_reference": null,
"sender_account_number": "0000000000012",
"sender_routing_code": null,
"receiver_account_number": "000000012",
"receiver_routing_code": null,
"short_reference": "IF-20260101-ABCDEF",
"created_at": "2026-01-01T00:00:00+00:00",
"updated_at": "2026-01-01T00:00:00+00:00"
}
}
},
"errors": null
}
