> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payglocal.in/llms.txt
> Use this file to discover all available pages before exploring further.

# MCA Demo Funding Ingestion

> Simulates an inbound funding event for MCA testing. Available in the UAT (sandbox)
environment only — do not use for production transactions.


## When to Use

Use this endpoint to test MCA ingestion by simulating an inbound funding event for a given `transactingMid`.

<Warning>
  This endpoint is available in the **UAT (sandbox) environment only**. Do not use it for production traffic.
</Warning>


## OpenAPI

````yaml POST /gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion
openapi: 3.0.3
info:
  title: PayGlocal API
  description: >
    PayGlocal REST API covering merchant onboarding, payment initiation,
    refunds,

    capture, reversal, and standing-instruction (subscription) flows.
  version: '2.0'
  contact:
    name: PayGlocal Support
    email: merchant.support@payglocal.in
    url: https://payglocal.in
servers:
  - url: https://api.onboard.payglocal.in
    description: Onboarding — Production
  - url: https://api.onboard.uat.payglocal.in
    description: Onboarding — Sandbox
  - url: https://api.payglocal.in
    description: Payments — Production
  - url: https://api.uat.payglocal.in
    description: Payments — Sandbox
  - url: https://gcc.prod.payglocal.in
    description: MCA — Production
  - url: https://gcc.uat.payglocal.in
    description: MCA — Sandbox
security:
  - ApiKeyAuth: []
    DigestAuth: []
tags:
  - name: Merchant Onboarding
    description: Endpoints to create and manage merchant onboarding records.
  - name: Reference Data
    description: Lookup endpoints for static reference data (categories, codes).
  - name: Payment
    description: Payment initiation, refund, capture, reversal, and status endpoints.
  - name: Standing Instructions
    description: Subscription / recurring-payment mandate operations.
  - name: MCA
    description: >-
      Merchant Collection Account — virtual account fetch and transaction
      document upload.
paths:
  /gcc/v1/ffms/transaction/demo-funding/{transactingMid}/mca-ingestion:
    servers:
      - url: https://gcc.uat.payglocal.in
        description: MCA — Sandbox
    post:
      tags:
        - MCA
      summary: MCA Demo Funding Ingestion
      description: >
        Simulates an inbound funding event for MCA testing. Available in the UAT
        (sandbox)

        environment only — do not use for production transactions.
      operationId: mcaDemoFundingIngestion
      parameters:
        - name: transactingMid
          in: path
          required: true
          schema:
            type: string
          description: Identifier for the transacting entity.
          example: transacting_001
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/McaDemoFundingIngestionRequest'
            example:
              currency: USD
              amount: '1'
              senderCountry: US
              senderName: test
      responses:
        '200':
          description: Demo funding transaction created.
          content:
            application/json:
              schema:
                type: object
                properties:
                  gid:
                    type: string
                    nullable: true
                    example: null
                  status:
                    type: string
                    example: 200 OK
                  message:
                    type: string
                    example: demo funding transaction created
                  timestamp:
                    type: string
                    example: 01/01/2026 00:00:00
                  reasonCode:
                    type: string
                    example: GL-201-001
                  data:
                    type: object
                    properties:
                      fundingTransaction:
                        type: object
                        properties:
                          transactionId:
                            type: string
                            example: 00000000-0000-0000-0000-000000000000
                          status:
                            type: string
                            example: pending
                          rawResponse:
                            type: object
                            description: >-
                              Raw response passed through from the underlying
                              funding provider.
                            properties:
                              id:
                                type: string
                                example: 00000000-0000-0000-0000-000000000000
                              state:
                                type: string
                                example: pending
                              amount:
                                type: string
                                example: '10.00'
                              currency:
                                type: string
                                example: CAD
                              action:
                                type: string
                                example: approve
                              account_id:
                                type: string
                                example: 11111111-1111-1111-1111-111111111111
                              sender_name:
                                type: string
                                example: Jane Doe
                              sender_address:
                                type: string
                                nullable: true
                                example: null
                              sender_country:
                                type: string
                                example: AE
                              sender_reference:
                                type: string
                                nullable: true
                                example: null
                              sender_account_number:
                                type: string
                                example: '0000000000000'
                              sender_routing_code:
                                type: string
                                nullable: true
                                example: null
                              receiver_account_number:
                                type: string
                                example: '000000000'
                              receiver_routing_code:
                                type: string
                                nullable: true
                                example: null
                              short_reference:
                                type: string
                                example: IF-20260101-ABCDEF
                              created_at:
                                type: string
                                format: date-time
                                example: '2026-01-01T00:00:00+00:00'
                              updated_at:
                                type: string
                                format: date-time
                                example: '2026-01-01T00:00:00+00:00'
                  errors:
                    type: object
                    nullable: true
                    example: null
              example:
                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
      security:
        - ApiKeyAuth: []
components:
  schemas:
    McaDemoFundingIngestionRequest:
      type: object
      required:
        - currency
        - amount
        - senderCountry
        - senderName
      properties:
        currency:
          type: string
          description: ISO 4217 currency code.
          example: USD
        amount:
          type: string
          description: Funding amount.
          example: '1'
        senderCountry:
          type: string
          description: ISO country code of the sender.
          example: US
        senderName:
          type: string
          description: Name of the sender.
          example: test
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-gl-auth
      description: Static API Key generated from the PayGlocal Partner Dashboard.
    DigestAuth:
      type: apiKey
      in: header
      name: x-gl-digest
      description: >
        Per-request HmacSHA256 signature, Base64-encoded, using your API Secret
        as the HMAC key.

        - For GET requests: sign the request URI path (e.g.
        `/gcc/v2/partner/merchant/onboard/business-category`), including query
        string if present.

        - For POST/PUT requests: sign the exact raw request body.

````