PApaymongo
PayMongo Wallet

Debit a PayMongo Wallet

Creates one transaction per attach attempt and sends the debit from the payer's wallet to the PayMongo wallet named by settlement_type (the settlement account by default, or the Instant Settlement source account) through the Transfers API. Idempotent on attach_attempt_id. A decline is a 200 whose transaction_status is failed and whose failed_code names the reason; a provider outage is a 503 with the row left pending for refresh.

post/v1/paymongo_wallet/transactions

Request

  • Base URL
    https://ewallets-api.paymongo.com
  • URL
    https://ewallets-api.paymongo.com/v1/paymongo_wallet/transactions
  • Auth
    HTTP basic

Request body

amountinteger required
attach_attempt_idstring required
callback_urlstring required
currencystring required
descriptionstring
link_idstring
livemodeboolean required
metadataobject

Metadata is carried onto the transfer as-is, next to the reserved keys this service sets. A renewal names its subscription and invoice here so statements and support can tell it from a one-off payment.

organization_idstring required
payer_account_numberstring
settlement_type'payout' | 'instant_settlement'

Example request

{
  "amount": 5000,
  "attach_attempt_id": "att_abc123",
  "callback_url": "https://api.paymongo.com/paymongo_wallet/webhook",
  "currency": "PHP",
  "description": "Vivamax monthly plan",
  "link_id": "pmwl_abc123",
  "livemode": true,
  "organization_id": "org_abc123",
  "payer_account_number": "1234567890",
  "settlement_type": "instant_settlement"
}

Response

Transaction created, or the existing one for a repeated attach attempt

has_moreboolean

Example response

{
  "data": {
    "amount": 5000,
    "attach_attempt_id": "att_abc123",
    "created_at": "2026-09-28 00:00:00+00:00",
    "currency": "PHP",
    "failed_code": "insufficient_funds",
    "id": "pmw_abc123",
    "link_id": "pmwl_abc123",
    "livemode": true,
    "organization_id": "org_abc123",
    "payer_account_number": "1234567890",
    "reversal_transfer_id": "tr_def456",
    "reversed_at": "2026-09-28 00:00:00+00:00",
    "succeeded_at": "2026-09-28 00:00:00+00:00",
    "transaction_status": "pending",
    "transfer_id": "tr_abc123",
    "updated_at": "2026-09-28 00:00:00+00:00"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.