Overview
When funds arrive in a merchant’s virtual account, PayGlocal requires a supporting document, typically an invoice, before the transaction can be settled. You provide it through a single-call presigned URL flow:- Host the PDF yourself and generate a presigned URL for it from your own storage (for example an S3 bucket you control).
- Call PayGlocal’s upload endpoint with that
presignedUrlin the request body. PayGlocal downloads the file from it and stores it for the transaction.
When to Trigger This
Call the upload endpoint as soon as you receive anMCA_FUND_RECEIVED webhook with status DOCUMENT_PENDING. Take the gid from the webhook payload and pass it in the path.
DOCUMENT_PENDING. If it is not, the call returns 400.
Request the Upload
Send your API key in thex-gl-auth header. No x-gl-digest is needed for this endpoint.
https://gcc.uat.payglocal.in.
Optional fields:
Example request body:
What a 200 Response Means
A200 OK means PayGlocal downloaded and stored the file. It does not mean the document is approved. After the 200:
- The file is checked for size (10 MB maximum) and type (PDF).
- PayGlocal’s compliance team reviews the document against the transaction.
File Requirements
- PDF only. The file name must end in
.pdf. - 10 MB maximum.
- Put the invoice number in the file name so the document is traceable (for example
invoice_INV-2026-00321.pdf).
If PayGlocal Needs a Different Document
If the compliance team needs more information, you receive aCHANGE_REQUESTED alert webhook with a reason. The transaction goes back to DOCUMENT_PENDING. Upload a corrected document with the same endpoint and the same gid. See MCA Webhook Events.
Retrying and Re-uploading
- If the call fails with
Failed to download file from presigned URL, nothing was saved. Fix the URL and call again. - While a transaction is still
DOCUMENT_PENDING, you can upload again with a new file. - Do not send two uploads for the same
gidat the same time. The second one returns409.
After the Upload
Once the document is accepted, PayGlocal will:- Send you a
TXN_SENT_FOR_SETTLEMENTwebhook when the transaction is submitted for settlement. - Send you a
TXN_SETTLEDwebhook when the funds are settled to the merchant’s account. - Send you a
FIRC_RECEIVEDwebhook when the FIRC is ready.
Errors
For the full API spec and interactive playground, see Upload Document via Presigned URL.

