Skip to main content

​
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)

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

{
  "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

ewalletaccount_number
GCash+639171234567
PayMaya+639951234567
GrabPay+639181111222
ShopeePay+639222223333