Skip to content

Handle RFI for a Payment

Option 1: Upload via Merchant Dashboard

You can upload the requested documents directly from the Merchant Dashboard.

1. You create the Payment

2. If additional information is required, you'll see Action Required

RFI Action Required preview

3. The dashboard will prompt you to upload the required supporting documents

RFI Upload Documents preview

4. After upload, the status changes to Under Review

RFI Under Review preview

5. Final decision is shared via callback/webhook (and reflected on the dashboard)

Option 2: Upload via API

If you want to submit RFI documents through your backend, you can upload them using Glomopay's Respond to an RFI API.

When this happens:

During Create Payment, Glomopay runs risk checks as mentioned earlier.

If additional verification is required, the Create API returns:

  • status: action_required

What you get in the Create response

Along with the payment_id, you'll receive:

  • rfi_documents - a list of required documents, each containing:
    • rfi_document_id
    • required_document_type (e.g., passport)

Important: Each rfi_document_id represents one specific required document. You must upload documents against the same IDs.

What happens after you upload

Once all required documents are uploaded successfully:

  • Status changes to under_review
  • Glomopay reviews the submission
  • Status updates are sent via callback/webhook
  • If approved, status becomes active

Payment Flow (Example)

  1. The Create Payment API returns action_required along with:
    • The payment ID
    • One or more RFI document IDs with their required document types
  2. Upload the required documents using the Create a Document API.
  3. Call the Respond to an RFI API by supplying:
    • The RFI id from the payment's rfi object (returned in step 1)
    • For each document, the rfi_doc_id returned from step 1 and the doc_id returned from step 2
  4. After successfully uploading the documents, the Glomopay compliance team will review the documents and any status update will be communicated via a callback.