Walapay

https://docs.walapay.io
Admin
Walapay is a global money movement platform allowing businesses and developers to collect, hold, and...
Tokens:86,362
Snippets:692
Trust Score:6
Update:5 months ago
Show doc for...
Tokens:
Raw
### cURL Request Example

Source: https://docs.walapay.io/reference/accountscontroller_findallforcustomer

Demonstrates how to make a GET request to retrieve all accounts for a given customer ID using cURL. This example shows the basic structure of the request.

```Shell
curl --request GET \
     --url https://sandbox-api.walapay.io/v1/accounts/customer/customerId
```

--------------------------------

### cURL Request Example

Source: https://docs.walapay.io/reference/paymentscontroller_findallforcustomer

This example demonstrates how to make a GET request to retrieve all payments for a given customer ID using cURL. It shows the basic URL structure and the method.

```shell
curl --request GET \
     --url https://sandbox-api.walapay.io/v1/payments/customer/customerId
```

--------------------------------

### Example Response/Webhook Structure (March 30th onwards)

Source: https://docs.walapay.io/docs/change-log

Illustrates the updated structure for responses and webhooks starting March 30th. Includes details on transaction lifecycle, source, destination, and funding instructions.

```json
{
    "id": "wm5tzpjwzigabt199y529t17",
    "lifecycle": {
        "createdAt": "2026-02-18T18:53:03.109Z",
        "sentAt": "2026-02-18T18:53:03.109Z",
        "completedAt": "2026-02-18T18:53:03.109Z",
        "expiredAt": null,
        "refundedAt": null
    },
    "customerId": "cm5e74nqk0003x228bspddfe8",
    "status": "PROCESSING",
    "statusReasons": null,
    "error": null,
    "type": "EXTERNAL",
    "comment": null,
    "reference": null,
    "returnAddress": null,
    "paymentReason": "PAYMENT_FOR_GOODS_AND_SERVICES",
    "fee": 1.07,
    "developerFee": {
        "fixed": null,
        "variable": null,
        "total": null
    },
    "quote": {
        "exchangeRate": 1,
        "expiresAt": "2026-02-18T18:53:03.109Z"
    },
    "tracking": {
        "traceNumber": null,
        "omad": null,
        "imad": null,
        "certificate": null,
        "uetr": null
    },
    "files": [
        "https://walapay-...."
    ],
    "configurations": {
        "expiredQuoteBehavior": "REFUND_PAYMENT"
    },
    "source": {
        "amount": 10,
        "currencyCode": "USDC",
        "accountId": null,
        "rail": "POLYGON",
        "fromAddress": "0x82553ce775b52e0cab198bc057bb0c21f10d5f07",
        "transactionHash": "0x82553ce775b52e0cab198bc057bb0c21f10d5f07",
        "fromAccountNumber": null
    },
    "destination": {
        "amount": 8.93,
        "rail": "LOCAL",
        "currencyCode": "GBP",
        "transactionHash": "0x82553ce775b52e0cab198bc057bb0c21f10d5f07",
        "accountId": "cmlrcej3j0001ky7ljor6rl7x"
    },
    "fundingInstructions": {
        "rail": "POLYGON",
        "amount": 10,
        "toAddress": "0xExampleAddress1234567890098765432",
        "fromAddress": "0x82553ce775b52e0CaB198bc057bb0c21f10D5F07",
        "currencyCode": "USDC"
    }
}
```

--------------------------------

### Get All Customers Request

Source: https://docs.walapay.io/reference/customerscontroller_findallcustomers

This cURL command demonstrates how to make a GET request to retrieve all customers for your team. Ensure you include the 'accept' header for JSON responses.

```Shell
curl --request GET \
     --url https://sandbox-api.walapay.io/v1/customers \
     --header 'accept: application/json'
```

--------------------------------

### Create Customer Request Example

Source: https://docs.walapay.io/docs/customers

This JSON structure represents a request to create a customer, including personal details and supporting documents like proof of address. Refer to the API Reference for complete examples.

```json
{
    "expirationDate": "2031-04-20",
    "frontImage": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    },
    "supportingDocuments": [
        {
            "type": "PROOF_OF_ADDRESS",
            "file": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
            "description": "Utility bill",
            "subType": "UTILITY_BILL"
        }
    ]
}
```

--------------------------------

### Create Customer with KYC Link (Python)

Source: https://docs.walapay.io/reference/customerscontroller_createcustomerwithkyclink

This Python script utilizes the `requests` library to create a customer and generate a KYC link. Ensure the `requests` library is installed (`pip install requests`).

```python
import requests
import json

url = "https://sandbox-api.walapay.io/v1/customers/kyc-link"

headers = {
    "Content-Type": "application/json"
}

payload = {
    "type": "INDIVIDUAL",
    "email": "test@example.com",
    "redirectUrl": "https://example.com/redirect",
    "firstName": "John",
    "lastName": "Doe",
    "capabilities": ["USD", "OTHER"]
}

response = requests.post(url, headers=headers, data=json.dumps(payload))

if response.status_code == 201:
    print("Customer created successfully:", response.json())
else:
    print("Error creating customer:", response.status_code, response.text)
```

--------------------------------

### POST /accounts Request Example

Source: https://docs.walapay.io/docs/change-log

Example JSON request body for creating an account, specifying currency, third-party status, and desired payment rails (e.g., TED, PIX for BRL).

```json
{
    "type": "EXTERNAL_BANK_ACCOUNT",
    "currencyCode": "BRL",
    "isThirdParty": true,
    "rails": ["TED", "PIX"],
    "bank": {
        "name": "BANCO DO BRASIL S.A",
    ....
}
```

--------------------------------

### Compare GET /payments/rate/walapay (Before) vs GET /payments/rate (After)

Source: https://docs.walapay.io/docs/change-log

Illustrates the response structure change for fetching payment rates. The new endpoint consolidates fee and rate information.

```json Response
{
    "midMarketRate": 5.4952529294,
    "invertedMidMarketRate": 0.1819755763,
    "walapayFees": {
        "description": "The Walapay fees for the payment based on the destination rail",
        "LOCAL": {
            "fixed": 1,
            "variable": 0.001
        },
        "WIRE": {
            "fixed": 45,
            "variable": 0.0065
        },
        "CRYPTO": {
            "fixed": null,
            "variable": null
        }
    },
    "walapayRates": {
        "description": "[Deprecated] The mid market rate minus the Walapay variable fee: mid market rate * (1 - Walapay variable fee)",
        "LOCAL": 5.4897576764706,
        "WIRE": 5.459533785358901,
        "CRYPTO": null
    },
    "developerFees": {
        "description": "The developer fees for the payment. Added on top of the walapay fees.",
        "fixed": null,
        "variable": null
    },
    "calculatedAmounts": {
        "LOCAL": {
            "sourceAmount": 679.27,
            "destinationAmount": 3723.52,
            "totalFeeInSourceCurrency": 1.68
        },
        "WIRE": {
            "sourceAmount": 727.03,
            "destinationAmount": 3723.52,
            "totalFeeInSourceCurrency": 49.44
        },
        "CRYPTO": {
            "sourceAmount": null,
            "destinationAmount": null,
            "totalFeeInSourceCurrency": null
        }
    },
    "quoteId": "cmdxts4kx0000dunid010mqd7"
}
```

```json Response
{
    "midMarketRate": 5.495449870300001,
    "invertedMidMarketRate": 0.18196857419999998,
    "walapayFee": {
        "fixed": 1,
        "variable": 0.007
    },
    "developerFee": {
        "fixed": 1,
        "variable": 0.01
    },
    "calculatedAmount": {
        "description": "The calculated amounts for the payment, along with total fee (both walapay and developer).destinationAmount = (((sourceAmount - walapayFixedFee) * (1 - walapayVariableFee)) - developerFixedFee) * midMarketRate * (1 - developerVariableFee). sourceAmount = (destinationAmount / (midMarketRate * (1 - developerVariableFee)) + developerFixedFee) / (1 - walapayVariableFee) + walapayFixedFee.",
        "sourceAmount": 691.24,
        "destinationAmount": 3723.52,
        "totalFeeInSourceCurrency": 13.68
    },
    "quoteId": "cmdxtdy6e000010y04ovhu28i"
}
```

--------------------------------

### Create Customer with KYC Link (Node.js)

Source: https://docs.walapay.io/reference/customerscontroller_createcustomerwithkyclink

This Node.js example demonstrates how to create a customer and generate a KYC link. It requires the `axios` library for making HTTP requests.

```javascript
const axios = require('axios');

const createCustomer = async () => {
  try {
    const response = await axios.post('https://sandbox-api.walapay.io/v1/customers/kyc-link', {
      type: 'INDIVIDUAL',
      email: 'test@example.com',
      redirectUrl: 'https://example.com/redirect',
      firstName: 'John',
      lastName: 'Doe',
      capabilities: ['USD', 'OTHER']
    });
    console.log('Customer created:', response.data);
  } catch (error) {
    console.error('Error creating customer:', error.response ? error.response.data : error.message);
  }
};

createCustomer();
```

--------------------------------

### GET /payments/rate

Source: https://docs.walapay.io/docs/change-log

Retrieves the specific rail details for payment rates. This endpoint replaces the deprecated GET /payments/rate/walapay.

```APIDOC
## GET /payments/rate

### Description
Retrieves the specific rail details for payment rates. This endpoint replaces the deprecated GET /payments/rate/walapay.

### Method
GET

### Endpoint
/payments/rate

### Parameters
#### Query Parameters
- **sourceRail** (string) - Required - The source rail for the payment.
- **destinationRail** (string) - Required - The destination rail for the payment. Use "LOCAL" to map to the appropriate country-specific rail.

### Response
#### Success Response (200)
- **midMarketRate** (number) - The mid-market exchange rate.
- **invertedMidMarketRate** (number) - The inverted mid-market exchange rate.
- **walapayFee** (object) - Details of Walapay fees.
  - **fixed** (number) - The fixed component of the Walapay fee.
  - **variable** (number) - The variable component of the Walapay fee.
- **developerFee** (object) - Details of developer fees.
  - **fixed** (number) - The fixed component of the developer fee.
  - **variable** (number) - The variable component of the developer fee.
- **calculatedAmount** (object) - The calculated amounts for the payment.
  - **description** (string) - Formula for calculating amounts.
  - **sourceAmount** (number) - The amount in the source currency.
  - **destinationAmount** (number) - The amount in the destination currency.
  - **totalFeeInSourceCurrency** (number) - The total fee in the source currency.
- **quoteId** (string) - The ID of the quote.

### Response Example
```json
{
    "midMarketRate": 5.495449870300001,
    "invertedMidMarketRate": 0.18196857419999998,
    "walapayFee": {
        "fixed": 1,
        "variable": 0.007
    },
    "developerFee": {
        "fixed": 1,
        "variable": 0.01
    },
    "calculatedAmount": {
        "description": "The calculated amounts for the payment, along with total fee (both walapay and developer).destinationAmount = (((sourceAmount - walapayFixedFee) * (1 - walapayVariableFee)) - developerFixedFee) * midMarketRate * (1 - developerVariableFee). sourceAmount = (destinationAmount / (midMarketRate * (1 - developerVariableFee)) + developerFixedFee) / (1 - walapayVariableFee) + walapayFixedFee.",
        "sourceAmount": 691.24,
        "destinationAmount": 3723.52,
        "totalFeeInSourceCurrency": 13.68
    },
    "quoteId": "cmdxtdy6e000010y04ovhu28i"
}
```
```

--------------------------------

### Get Available Corridors

Source: https://docs.walapay.io/docs/change-log

Retrieves a list of available payment corridors, including supported blockchains and fiat rails. This endpoint replaces the deprecated GET /configurations/corridors.

```APIDOC
## GET /payments/corridors

### Description
Retrieves a list of available payment corridors, including supported blockchains and fiat rails. This endpoint replaces the deprecated GET /configurations/corridors.

### Method
GET

### Endpoint
/payments/corridors

### Response
#### Success Response (200)
- **data** (array) - An array of available corridors.
  - **source** (object)
    - **currencyCodes** (array) - List of supported source currency codes.
    - **rails** (array) - List of supported source rails (e.g., blockchains, fiat rails).
  - **destination** (object)
    - **currencyCodes** (array) - List of supported destination currency codes.
    - **rails** (array) - List of supported destination rails.
    - **countryCode** (string) - The country code for the destination.
  - **fees** (object)
    - **fixed** (number) - The fixed fee for the corridor.
    - **variable** (number) - The variable fee for the corridor.

### Response Example
```json
{
  "data": [
    {
      "source": {
        "currencyCodes": [
          "USDC",
          "USDT",
          "EURC"
        ],
        "rails": [
          "POLYGON",
          "ETHEREUM",
          "BASE",
          "SOLANA",
          "TRON"
        ]
      },
      "destination": {
        "currencyCodes": [
          "BRL"
        ],
        "rails": [
          "TED"
        ],
        "countryCode": "BR"
      },
      "fees": {
        "fixed": 1,
        "variable": 0.005
      }
    }
  ]
}
```
```

--------------------------------

### Create Customer with KYC Link (Shell)

Source: https://docs.walapay.io/reference/customerscontroller_createcustomerwithkyclink

Use this command to create a customer and obtain a KYC link. Ensure you replace placeholder values with actual customer data.

```shell
curl -X POST \
  https://sandbox-api.walapay.io/v1/customers/kyc-link \
  -H 'Content-Type: application/json' \
  -d '{ 
    "type": "INDIVIDUAL", 
    "email": "test@example.com", 
    "redirectUrl": "https://example.com/redirect", 
    "firstName": "John", 
    "lastName": "Doe", 
    "capabilities": ["USD", "OTHER"]
  }'
```

--------------------------------

### Before: GET configurations/corridors Response Structure

Source: https://docs.walapay.io/docs/change-log

This JSON structure represents the response from the deprecated GET /configurations/corridors endpoint, showing fee details for specific payment types.

```json
"data": [
        {
            "source": {
                "currencyCode": "USDC",
                "chain": "POLYGON"
            },
            "destination": {
                "currencyCode": "BRL",
                "chain": null,
                "countryCode": "BR"
            },
            "fees": {
                "LOCAL": {
                    "fixedFeeInUSD": 1,
                    "variableFeeInSourceCurrency": 0.005
                },
                "CRYPTO": {
                    "fixedFeeInUSD": 1,
                    "variableFeeInSourceCurrency": 0.005
                },
                "WIRE": {
                    "fixedFeeInUSD": null,
                    "variableFeeInSourceCurrency": null
                }
            }
        }
]
```

--------------------------------

### Create Customer with KYC Link (Ruby)

Source: https://docs.walapay.io/reference/customerscontroller_createcustomerwithkyclink

This Ruby script shows how to create a customer and get a KYC link using the `net/http` library. Adjust the payload with your customer's details.

```ruby
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://sandbox-api.walapay.io/v1/customers/kyc-link')

request = Net::HTTP::Post.new(uri.request_uri)
request['Content-Type'] = 'application/json'

request.body = {
  type: 'INDIVIDUAL',
  email: 'test@example.com',
  redirectUrl: 'https://example.com/redirect',
  firstName: 'John',
  lastName: 'Doe',
  capabilities: ['USD', 'OTHER']
}.to_json

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)
```

--------------------------------

### Create Customer with KYC Link (PHP)

Source: https://docs.walapay.io/reference/customerscontroller_createcustomerwithkyclink

This PHP example uses cURL to create a customer and obtain a KYC link. Remember to set the correct `Content-Type` header and JSON payload.

```php
<?php

$url = 'https://sandbox-api.walapay.io/v1/customers/kyc-link';

$data = [
    'type' => 'INDIVIDUAL',
    'email' => 'test@example.com',
    'redirectUrl' => 'https://example.com/redirect',
    'firstName' => 'John',
    'lastName' => 'Doe',
    'capabilities' => ['USD', 'OTHER']
];

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Content-Length: ' . strlen($payload)
]);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>
```

--------------------------------

### Customer Creation with Specific Capabilities

Source: https://docs.walapay.io/docs/change-log

Example JSON request for creating a new customer. The 'capabilities' parameter allows specifying access to USD or OTHER corridors, influencing compliance checks.

```json
{
    "type": "INDIVIDUAL",
    "capabilities": ["OTHER"], // Optional
    "firstName": "Jason",
    "lastName": "Smith",
    ....
}
```

--------------------------------

### Get Exchange Rate (Shell)

Source: https://docs.walapay.io/reference/paymentscontroller_getrate

Use this cURL command to get the exchange rate between two currencies. Ensure you replace placeholder values with actual currency codes.

```shell
curl --request GET \
     --url 'https://sandbox-api.walapay.io/v1/payments/rate/walapay?sourceCurrencyCode=AED&destinationCurrencyCode=AED'
```

--------------------------------

### cURL Request to Get Payment by ID

Source: https://docs.walapay.io/reference/paymentscontroller_findone

Use this cURL command to make a GET request to retrieve a specific payment. Replace '{id}' with the actual payment ID.

```shell
curl --request GET \
     --url https://sandbox-api.walapay.io/v1/payments/id
```

--------------------------------

### Get Account Requirements

Source: https://docs.walapay.io/docs/change-log

Retrieves the requirements for creating an account, specifying parameters needed for different account holder types and rails. This endpoint replaces the deprecated GET /accounts/requirements/external-bank-accounts.

```APIDOC
## GET /requirements

### Description
Retrieves the requirements for creating an account, specifying parameters needed for different account holder types and rails. This endpoint replaces the deprecated GET /accounts/requirements/external-bank-accounts.

### Method
GET

### Endpoint
/requirements

### Response
#### Success Response (200)
- **variableName** (string) - The name of the variable.
- **rails** (array) - The payment rails this requirement applies to.
- **accountHolderTypes** (array) - The types of account holders this requirement applies to (e.g., INDIVIDUAL, BUSINESS).
- **regex** (string) - A regular expression for validating the field's value.
- **example** (string) - An example value for the field.
- **enum** (array) - A list of allowed values if applicable.

#### Response Example
```json
[
    {
        "variableName": "bank.accountNumber",
        "rails": [
            "TED"
        ],
        "accountHolderTypes": [
            "INDIVIDUAL",
            "BUSINESS"
        ],
        "regex": "^[0-9]{2,15}$",
        "example": "001000456789",
        "enum": []
    },
    {
        "variableName": "bank.pixCode",
        "rails": [
            "PIX"
        ],
        "accountHolderTypes": [
            "INDIVIDUAL",
            "BUSINESS"
        ],
        "regex": "^.{1,100}$",
        "example": "01.234.456/5432-10 (cnpj) | 123.456.789-87 (cpf) | +5511912345678",
        "enum": []
    }
]
```
```

--------------------------------

### After: GET payments/corridors Response Structure

Source: https://docs.walapay.io/docs/change-log

This JSON structure represents the response from the new GET /payments/corridors endpoint, detailing available currency codes and rails, with consolidated fee information.

```json
"data": [
        {
            "source": {
                "currencyCodes": [
                    "USDC",
                    "USDT",
                    "EURC"
                ],
                "rails": [
                    "POLYGON",
                    "ETHEREUM",
                    "BASE",
                    "SOLANA",
                    "TRON"
                ]
            },
            "destination": {
                "currencyCodes": [
                    "BRL"
                ],
                "rails": [
                    "TED"
                ],
                "countryCode": "BR"
            },
            "fees": {
                "fixed": 1,
                "variable": 0.005
            }
        }
]
```

--------------------------------

### Create Business Customer

Source: https://docs.walapay.io/docs/customers

Use this endpoint to create a new business customer. Ensure the business address is a physical location, not a virtual address or PO box.

```bash
curl --request POST \
  --url 'https://sandbox-api.walapay.io/v1/customers' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --data '{ \
    "type": "BUSINESS", \
    "businessName": "Acme", \
    "email": "justin@acme.com" \
}'
```

--------------------------------

### Get webhooks for team (cURL)

Source: https://docs.walapay.io/reference/webhooks

Use this cURL command to make a GET request to the Walapay API to retrieve webhooks for a team. Ensure you have the correct API key for authentication.

```shell
curl --request GET \
     --url https://sandbox-api.walapay.io/v1/webhooks
```

--------------------------------

### cURL Request to Get All Payments

Source: https://docs.walapay.io/reference/paymentscontroller_findallforteam

This snippet demonstrates how to make a GET request to the Walapay API to retrieve all payments for a team using cURL. It shows the base URL and the request method.

```shell
curl --request GET \
     --url https://sandbox-api.walapay.io/v1/payments
```

--------------------------------

### Fiat to Stablecoin with Source Account ID (BRL to USDT)

Source: https://docs.walapay.io/docs/fiat-to-stablecoin

This example demonstrates funding a payment from a BRL virtual account to a USDT stablecoin. Ensure the source virtual account has sufficient balance.

```curl
curl --request POST \
  --url 'https://sandbox-api.walapay.io/v1/payments/<customerId>' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
  --header 'X-Idempotency-Key: ced13348-d16d-4310-aa07-b3264cb00bc4' \
  --data '{ \
  "source": { \
    "currencyCode": "BRL", \
    "amount": 100, \
    "accountId": "c202409241621308758eb7c1970159" \
  }, \
  "destination": { \
    "currencyCode": "USDT", \
    "rail": "ETHEREUM", \
    "accountId": "d15d4441-bba9-48d2-8cb4-cb9d0273ac51" \
  }, \
  "comment": "Test BRL to USDT payment", \
  "reference": "For testing purposes", \
  "paymentReason": "Testing fiat to crypto payment", \
  "sourceOfFunds": "PERSONAL_ACCOUNT" \
}'
```

--------------------------------

### Create Customer

Source: https://docs.walapay.io/docs/customers

This snippet demonstrates how to create a new customer by sending a POST request to the /customers endpoint with the necessary customer information in the request body.

```APIDOC
## POST /customers

### Description
Creates a new customer profile in the Walapay system.

### Method
POST

### Endpoint
/v1/customers

### Request Body
- **type** (string) - Required - Type of customer (e.g., BUSINESS, INDIVIDUAL).
- **legalName** (string) - Required - The legal name of the business or individual.
- **tradeName** (string) - Optional - The trade name if different from the legal name.
- **businessType** (string) - Optional - The type of business (e.g., C_CORPORATION).
- **description** (string) - Optional - A brief description of the customer or business.
- **industry** (string) - Optional - Industry code.
- **website** (string) - Optional - Customer's website URL.
- **email** (string) - Required - Customer's email address.
- **phone** (string) - Required - Customer's phone number.
- **phoneCountryCode** (string) - Required - Country code for the phone number (e.g., PH).
- **address** (object) - Required - Customer's address details.
  - **streetLine1** (string) - Required.
  - **streetLine2** (string) - Optional.
  - **city** (string) - Required.
  - **stateRegionOrProvince** (string) - Required.
  - **postalCode** (string) - Required.
  - **countryCode** (string) - Required.
- **accountPurpose** (string) - Optional - The purpose of the account.
- **sourceOfFunds** (string) - Optional - The source of funds for the account.
- **estimatedAnnualRevenueUSD** (string) - Optional - Estimated annual revenue.
- **expectedMonthlyPaymentsUSD** (number) - Optional - Expected monthly payments in USD.
- **isDao** (boolean) - Optional - Indicates if the entity is a DAO.
- **conductsMoneyServices** (boolean) - Optional - Indicates if the entity conducts money services.
- **operatesInProhibitedCountries** (boolean) - Optional - Indicates if the entity operates in prohibited countries.
- **taxIdentificationNumber** (string) - Optional - Tax identification number.
- **registrationNumber** (string) - Optional - Business registration number.
- **registrationDate** (string) - Optional - Date of registration (YYYY-MM-DD).
- **supportingDocuments** (array) - Optional - Array of supporting documents.
  - **type** (string) - Required - Type of document (e.g., BUSINESS_FORMATION).
  - **file** (string) - Required - Base64 encoded file data.
  - **description** (string) - Optional - Description of the document.
- **associatedPersons** (array) - Optional - Array of associated persons.
  - **firstName** (string) - Required.
  - **lastName** (string) - Required.
  - **email** (string) - Optional.
  - **phone** (string) - Optional.
  - **phoneCountryCode** (string) - Optional.
  - **address** (object) - Optional - Associated person's address.
  - **dateOfBirth** (string) - Optional - Date of birth (YYYY-MM-DD).
  - **percentageOwnership** (number) - Optional - Percentage of ownership.
  - **hasControl** (boolean) - Optional - Indicates if the person has control.
  - **title** (string) - Optional - Job title.
  - **isSigner** (boolean) - Optional - Indicates if the person is a signer.
  - **isDirector** (boolean) - Optional - Indicates if the person is a director.
  - **relationshipEstablishmentDate** (string) - Optional - Date relationship was established (YYYY-MM-DD).
  - **taxIdentificationNumber** (string) - Optional.
  - **governmentIssuedIdentification** (object) - Optional - Government-issued identification details.
    - **type** (string) - Required - Type of ID (e.g., PASSPORT).
    - **countryCode** (string) - Required.
    - **number** (string) - Required.
    - **issuanceDate** (string) - Optional - Date of issuance (YYYY-MM-DD).
    - **expirationDate** (string) - Optional - Date of expiration (YYYY-MM-DD).
    - **frontImage** (string) - Optional - Base64 encoded image of the front of the ID.

### Request Example
```json
{
  "type": "BUSINESS",
  "legalName": "Pilipinas Enterprises Inc",
  "tradeName": "Pilipinas Enterprises Inc",
  "businessType": "C_CORPORATION",
  "description": "Financial services corporation",
  "industry": "111120",
  "website": "www.example.com",
  "email": "business-123@example.com",
  "phone": "+639171234567",
  "phoneCountryCode": "PH",
  "address": {
    "streetLine1": "123 Ayala Avenue",
    "streetLine2": "Makati Central Business District",
    "city": "Makati",
    "stateRegionOrProvince": "01",
    "postalCode": "1226",
    "countryCode": "PH"
  },
  "accountPurpose": "CHARITABLE_DONATIONS",
  "sourceOfFunds": "BUSINESS_LOANS",
  "estimatedAnnualRevenueUSD": "UNDER_HUNDRED_THOUSAND",
  "expectedMonthlyPaymentsUSD": 10000,
  "isDao": false,
  "conductsMoneyServices": false,
  "operatesInProhibitedCountries": false,
  "taxIdentificationNumber": "123-456-789-000",
  "registrationNumber": "REG123456",
  "registrationDate": "2015-01-01",
  "supportingDocuments": [
    {
      "type": "BUSINESS_FORMATION",
      "file": "data:image/jpeg;base64,BASE64_ENCODED_IMAGE_DATA",
      "description": "Certificate of Incorporation"
    },
    {
      "type": "OWNERSHIP_INFORMATION",
      "file": "data:image/jpeg;base64,BASE64_ENCODED_IMAGE_DATA"
    },
    {
      "type": "BANK_STATEMENT",
      "file": "data:image/jpeg;base64,BASE64_ENCODED_IMAGE_DATA",
      "description": "Checking account Oct 2024"
    }
  ],
  "associatedPersons": [
    {
      "firstName": "Maria",
      "lastName": "Santos",
      "email": "ubo1-123@example.com",
      "phone": "+639171234568",
      "phoneCountryCode": "PH",
      "address": {
        "streetLine1": "456 Ortigas Avenue",
        "streetLine2": "Ortigas Center",
        "city": "Pasig",
        "stateRegionOrProvince": "AGS",
        "postalCode": "1605",
        "countryCode": "PH"
      },
      "dateOfBirth": "1990-01-01",
      "percentageOwnership": 60,
      "hasControl": true,
      "title": "CEO",
      "isSigner": true,
      "isDirector": true,
      "relationshipEstablishmentDate": "2015-01-01",
      "taxIdentificationNumber": "123-45-6789",
      "governmentIssuedIdentification": {
        "type": "PASSPORT",
        "countryCode": "PH",
        "number": "UBO123456",
        "issuanceDate": "2020-01-01",
        "expirationDate": "2030-01-01",
        "frontImage": "data:image/jpeg;base64,BASE64_ENCODED_IMAGE_DATA"
      }
    },
    {
      "firstName": "Jose",
      "lastName": "Reyes",
      "email": "ubo2-123@example.com",
      "phone": "+639171234569",
      "phoneCountryCode": "PH",
      "address": {
        "streetLine1": "789 Bonifacio High Street",
        "streetLine2": "Bonifacio Global City",
        "city": "Taguig",
        "stateRegionOrProvince": "AGS",
        "postalCode": "1634",
        "countryCode": "PH"
      },
      "dateOfBirth": "1990-01-01",
      "percentageOwnership": 40,
      "hasControl": false,
      "title": "CFO",
      "isSigner": false,
      "isDirector": true,
      "relationshipEstablishmentDate": "2015-01-01",
      "taxIdentificationNumber": "123-45-6789",
      "governmentIssuedIdentification": {
        "type": "PASSPORT",
        "countryCode": "PH",
        "number": "UBO123457",
        "issuanceDate": "2020-01-01",
        "expirationDate": "2030-01-01",
        "frontImage": "data:image/jpeg;base64,BASE64_ENCODED_IMAGE_DATA"
      }
    }
  ]
}
```

### Response
For example responses, please visit the API Reference's [Create Customer endpoint](https://docs.walapay.io/reference/customerscontroller_createcustomer#/) and click on one of the available examples.
```

--------------------------------

### cURL Request to Get All Accounts

Source: https://docs.walapay.io/reference/accountscontroller_findallforteam

This snippet demonstrates how to make a GET request to the Walapay API to retrieve all accounts for a team using cURL. It includes the base URL and necessary headers.

```Shell
curl --request GET \
     --url https://sandbox-api.walapay.io/v1/accounts \
     --header 'accept: application/json'
```
Tokens:
Raw