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

# Philippines – Wallet Payouts

# Philippines – Wallet Payouts (ewallet\_ph)

Wallet payouts in the **Philippines (PH)** provide a fast, secure, and cost-effective way to disburse funds to recipients using supported mobile wallet.

This guide outlines the technical and operational steps required to integrate and manage wallet payouts in the Philippines.

***

## Key Features

* **Instant payouts (real-time)**
* Currency: `PHP`

***

## Supported Values for `e-wallets`

* `GCash`
* `GrabPay`
* `PayMaya`
* `ShopeePay`

***

## Account Number Validation

You must implement validation and proper error handling for invalid wallet numbers.

## Sample Request – Create Payout (Philippines)

```bash theme={null}
curl --request POST \
  --url https://service.tazapay.com/v3/payout \
  --header 'Idempotency-Key: ref_ph_001' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    {
  "amount": 10000,
  "currency": "USD",
  "purpose": "PYR001",
  "transaction_description": "Test",
  "beneficiary_details": {
    "name": "Budi Santoso",
    "type": "individual",
    "destination_details": {
      "type": "local_payment_network",
      "local_payment_network": {
        "deposit_key": "081234567890",
        "type": "gopay_idr",
        "deposit_key_type": "phone"
      }
    }
  }
  }'
```

***

## Response – Create Payout

```json theme={null}
{
  "status": "success",
  "data": {
    "id": "pot_ph_example_001",
    "amount": 5000,
    "currency": "PHP",
    "status": "processing",
    "reference_id": "ref_ph_001",
    "created_at": "2025-05-16T10:20:40.716Z"
  }
}
```

***

## Payout Status & Webhooks

After creation, the payout moves to `processing`.

From `processing`, it may transition to:

* `requires_action` – Additional information required (KYC/regulatory)
* `succeeded` – Wallet credited successfully
* `failed` – Payout failed; funds are returned to your account

  * Failure reason available in `status_description`

Tazapay sends webhook notifications to your configured endpoint for all payout state changes.

> **Note:**
> The payout will fail if the `account_number` does not match the wallet provider’s registered details.

***

## Suggested Test Wallet Accounts

| ewallet   | account\_number |
| --------- | --------------- |
| GCash     | `+639171234567` |
| PayMaya   | `+639951234567` |
| GrabPay   | `+639181111222` |
| ShopeePay | `+639222223333` |