Skip to main content
POST
MCA Demo Funding Ingestion

When to Use

Use this endpoint in the sandbox to simulate an inbound funding event for a transactingMid, 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 the x-gl-auth header. No x-gl-digest is needed for this endpoint.
The sandbox host is https://gcc.uat.payglocal.in.

Request Rules

What Happens Next

The 200 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

Authorizations

x-gl-auth
string
header
required

Static API Key generated from the PayGlocal Partner Dashboard.

Path Parameters

transactingMid
string
required

Identifier for the transacting entity.

Body

application/json
currency
string
required

ISO 4217 currency code.

Example:

"USD"

amount
string
required

Funding amount.

Example:

"1"

senderName
string
required

Name of the sender.

Example:

"test"

senderCountry
string

ISO country code of the sender. Required for every currency except EUR, AUD and GBP.

Example:

"US"

debtorAccountNumber
string

Optional. Sandbox default is used when omitted.

debtorFinancialInstitutionCode
string

Optional. Sandbox default is used when omitted.

debtorIban
string

Optional.

paymentScheme
string

Optional. A sandbox default is used when omitted.

Response

200 - application/json

Demo funding transaction created.

gid
string | null
Example:

null

status
string
Example:

"200 OK"

message
string
Example:

"demo funding transaction created"

timestamp
string
Example:

"01/01/2026 00:00:00"

reasonCode
string
Example:

"GL-201-001"

data
object
errors
object | null
Example:

null