AutopayEG
    • Invoices
      • Create invoice
        POST
      • Get invoice
        GET
      • Cancel invoice
        POST
    • Merchant
      • Current merchant
        GET
    • Webhooks
      • Receive Autopay webhook
        POST
    • Schemas
      • InvoiceStatus
      • Provider
      • ErrorEnvelope
      • CreateInvoiceRequest
      • Invoice
      • CreateInvoiceResponse
      • GetInvoiceResponse
      • MerchantMeResponse
      • MerchantFees
      • MerchantTransaction
      • WebhookCustomer
      • WebhookEnvelope
      • WebhookData

    WebhookEnvelope

    {
        "event": "invoice.completed",
        "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "external_reference": "ORD-1001",
        "timestamp": "2026-08-17T10:12:00+00:00",
        "data": {
            "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
            "external_reference": "ORD-1001",
            "amount": "100.00",
            "currency": "EGP",
            "status": "pending",
            "transaction_id": 42,
            "provider": "vodafone_cash",
            "paid_at": "2026-08-17T10:12:00+00:00",
            "customer": {
                "name": "Ahmed Ali",
                "email": "customer@example.com",
                "phone": "01012345678",
                "metadata": {
                    "order_id": "1001"
                }
            },
            "flagged_reason": "amount_mismatch",
            "flagged_at": "2019-08-24T14:15:22.123Z",
            "failed_at": "2019-08-24T14:15:22.123Z",
            "cancelled_at": "2019-08-24T14:15:22.123Z",
            "expires_at": "2019-08-24T14:15:22.123Z",
            "created_at": "2019-08-24T14:15:22.123Z",
            "transaction": {
                "id": 42,
                "uuid": "a3f1c8e2-4b5d-4e6f-8a9b-1c2d3e4f5a6b",
                "invoice_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
                "provider": "vodafone_cash",
                "status": "verified",
                "currency": "EGP",
                "amount": "100.00",
                "received_amount": "100.00",
                "sender_identifier": "ahmed@instapay",
                "sender_name": "Ahmed Ali",
                "reference": "123456789",
                "is_flagged": false,
                "flag_reason": "amount_mismatch",
                "fees": {
                    "customer_total": "103.00",
                    "merchant_net": "100.00"
                },
                "matched_at": "2026-08-17T10:12:00+00:00",
                "created_at": "2026-08-17T10:05:00+00:00"
            },
            "matched_manually": true,
            "approved_from_flagged": true,
            "flag_reason": "amount_mismatch",
            "message": "string",
            "rejected_from_flagged": true,
            "reason": "string"
        }
    }
    Built with