Example Payloads

📘

Payload structure

Webhooks of event type "created" will send the same data as the object returned when sending a POST request to a resource. All webhooks of event type "updated" will send the same data as the object returned when sending a GET request to a resource.

Customer

{
    "eventId": "cm628749927yhiuvnnvxvc",
    "eventType": "customer.created",
    "eventObject": {
        "id": "cm41n4amh0001113u1k684yzb",
        "createdAt": "2024-11-28T18:20:37.193Z",
        "updatedAt": "2024-11-28T18:20:37.193Z",
        "type": "INDIVIDUAL",
        "kycStatus": "APPROVED",
        "kycUrl": "https://verify.walapay.io/kyc/123",
        "tosUrl": "https://verify.walapay.io/tos/123",
        "firstName": "John",
        "middleName": "Robert",
        "lastName": "Doe",
        "transliteratedFirstName": "Jon",
        "transliteratedMiddleName": "Robato",
        "transliteratedLastName": "Dou",
        "email": "[email protected]",
        "phone": "+1234567890",
        "phoneCountryCode": "US",
        "address": {
            "streetLine1": "123 Main St",
            "streetLine2": "Apt 4B",
            "city": "New York",
            "stateRegionOrProvince": "NY",
            "postalCode": "10001",
            "countryCode": "US"
        },
        "transliteratedAddress": {
            "streetLine1": "123 メイン通り",
            "streetLine2": "4B号室",
            "city": "ニューヨーク",
            "stateRegionOrProvince": "ニューヨーク州",
            "postalCode": "10001",
            "countryCode": "US"
        },
        "dateOfBirth": "1990-01-01",
        "employmentStatus": "EMPLOYED",
        "mostRecentOccupation": "15-1252",
        "sourceOfFunds": "EMPLOYMENT_INCOME",
        "accountPurpose": "BUSINESS_OPERATIONS",
        "accountPurposeExplanation": "Receiving salary payments and paying personal expenses",
        "expectedMonthlyPaymentsUSD": "UNDER_10K",
        "taxIdentificationNumber": "123-45-6789",
        "governmentIssuedIdentification": {
            "type": "PASSPORT",
            "countryCode": "CountryCode.US",
            "number": "P123456789",
            "issuanceDate": "2020-01-01",
            "expirationDate": "2030-01-01",
            "frontImage": "data:image/jpeg;base64,...",
            "backImage": "data:image/jpeg;base64,...",
            "selfie": "data:image/jpeg;base64,..."
        },
        "supportingDocuments": [
            {
                "type": "PROOF_OF_ADDRESS",
                "file": "data:image/jpeg;base64,...",
                "description": "Utility Bill"
            },
            {
                "type": "PROOF_OF_SOURCE_OF_FUNDS",
                "file": "data:image/jpeg;base64,...",
                "description": "Bank Statement"
            }
        ],
        "submissionIssues": []
    }
}

Account

External Bank Account Creation

{
    "eventId": "43a626d7-90f3-4e1e-ab94-e2099a249801",
    "eventObject": {
        "bank": {
            "accountNumber": "5748901293489024910",
            "accountType": "CHECKING",
            "address": {
                "city": "CABA",
                "countryCode": "AR",
                "postalCode": "C674AAK",
                "stateOrProvince": "C",
                "streetLine1": "Avenida Palermo 3039",
                "streetLine2": "CABA"
            },
            "bankCode": null,
            "bicSwift": null,
            "branchCode": null,
            "bsbNumber": null,
            "clabeNumber": null,
            "clearingCode": null,
            "cnapsCode": null,
            "iban": null,
            "ifscCode": null,
            "name": null,
            "nccNumber": null,
            "nubanCode": null,
            "pixCode": null,
            "routingNumber": null,
            "sortCode": null,
            "transitNumber": null
        },
        "createdAt": "2025-06-03T05:48:47.114Z",
        "currencyCode": "ARS",
        "digitalAssetWallet": null,
        "eWallet": null,
        "id": "43a626d7-90f3-4e1e-ab94-e2099a249801",
        "isDefault": true,
        "paymentAccountHolder": {
            "address": {
                "city": "Buenos Aires",
                "countryCode": "AR",
                "postalCode": "C1422DBH",
                "stateOrProvince": "C",
                "streetLine1": "Mariano 74",
                "streetLine2": "CABA"
            },
            "email": "[email protected]",
            "firstName": "Julia",
            "lastName": "Bonsa",
            "middleName": null,
            "phone": "+5491678987678",
            "type": "INDIVIDUAL"
        },
        "type": "EXTERNAL_BANK_ACCOUNT",
        "updatedAt": "2025-06-03T05:48:48.048Z"
    },
    "eventType": "account.created"
}

Virtual Bank Account Creation

{
    "eventId": "cm628749927yhiuvnnvxvc",
    "eventType": "account.created",
    "eventObject": {
        "id": "cm40psd0g0001xnyhdy6nmzmj",
        "createdAt": "2024-11-28T02:47:33.088Z",
        "updatedAt": "2024-11-28T02:47:33.088Z",
        "type": "VIRTUAL_BANK_ACCOUNT",
        "currencyCode": "USD",
        "status": "PENDING"
    }
}

Virtual Digital Asset Wallet Creation

{
    "eventId": "cm628749927yhiuvnnvxvc",
    "eventType": "account.created",
    "eventObject": {
        "id": "cm40psd0g0001xnyhdy6nmzmj",
        "createdAt": "2024-11-28T02:47:33.088Z",
        "updatedAt": "2024-11-28T02:47:33.088Z",
        "type": "VIRTUAL_DIGITAL_ASSET_WALLET",
        "chain": "POLYGON",
        "address": "0x123456789987654rfghjuytgh",
        "status": "APPROVED"
    }
}

Account Deposit

Virtual Digital Asset Wallet

{
    "eventId": "f7sdfs40-b231-4a08-a69f-basdfa828f",
    "eventType": "account.deposit",
    "eventObject": {
        "id": "c2025020gjds4550284n2k20611296", // Virtual Account ID
        "currencyCode": "USDC",
        "amount": 22790.748784,
        "paymentRail": "CRYPTO",
        "chain": "SOLANA",
        "fromAddress": "5tzFkiKslsdklDNCKSLKLASuoFbhUvuAi9"
    }
}

Virtual Bank Account

{
    "eventId": "f7sdfs40-b231-4a08-a69f-basdfa828f",
    "eventType": "account.deposit",
    "eventObject": {
        "id": "c2025020gjds4550284n2k20611296", // Virtual Account ID
        "currencyCode": "USD",
        "amount": 22790.74,
        "paymentRail": "WIRE"
    }
}

Payment

{
    "eventId": "20eef5b7-d7f1-45e7-a496-887332ec2c37",
    "eventObject": {
        "comment": null,
        "createdAt": "2025-06-04T15:41:42.417Z",
        "customerId": "20eef5b7-d7f1-45e7-a496-887332ec2c37",
        "destination": {
            "accountId": "20eef5b7-d7f1-45e7-a496-887332ec2c37",
            "amount": null,
            "currencyCode": "USDC",
            "rail": "CRYPTO"
        },
        "exchangeRate": null,
        "fee": null,
        "fundingInstructions": {
            "accountType": "savings",
            "amount": 2000,
            "bankName": "78 FINANCE COMPANY LIMITED",
            "currencyCode": "NGN",
            "nubanCode": "7001142452",
            "rail": "LOCAL"
        },
        "id": "20eef5b7-d7f1-45e7-a496-887332ec2c37",
        "paymentReason": "FX Conversion",
        "source": {
            "accountId": null,
            "amount": 2000,
            "chain": null,
            "currencyCode": "NGN",
            "fromAddress": null,
            "rail": "LOCAL"
        },
        "status": "PROCESSING",
        "updatedAt": "2025-06-04T15:58:49.723Z"
    },
    "eventType": "payment.updated"
}