Statuses, Messages, Webhook Events
Overview
Transfer statuses indicate the current state of a fund movement and can include values like pending
, succeeded
, or failed
. These statuses help track whether a transfer is still processing, has completed successfully, or encountered an issue. Webhooks are triggered on status changes, allowing you to automate workflows and keep your system in sync with real-time updates.
Statuses
Status | Meaning |
---|---|
Succeeded | Transaction was successful. |
Pending | Transaction is still processing. For Instapay, allow 20 minutes to finalize. For Pesonet, allow 1 day to have a final status. |
Failed | Transaction has failed and it should be safe to retry again. |
Callback URL
When creating transactions, you can include a callback_url
in the payload to receive real-time updates. PayMongo will send a webhook to this URL containing transaction details once an event occurs. This enables seamless tracking and automation of post-transaction processes.
The return payload should look like this:
{
"data": {
"id": "wallet_tr_AYD5d5e5J2NsHL15zy4ord4V",
"type": "wallet\_transaction",
"attributes": {
"wallet_id": "wallet_Y1fYZhnbA4JAiQy24ARbXbTE",
"amount": 100,
"batch_transaction_id": null,
"callback_url": "https://webhook.site/4b9ea436-4adf-483c-9a62-1e451489a2ee",
"currency": "PHP",
"description": "This is a wallet transaction.",
"fee": 0,
"livemode": true,
"metadata": null,
"net_amount": 100,
"provider": "paymongo",
"provider_error": null,
"provider_error_code": null,
"purpose": "PayMongo testmode wallet transaction",
"receiver": {
"bank_account_name": "Receiver Testmode",
"bank_account_number": "516646818064",
"bank_code": "PAEYPHM2XXX",
"bank_id": "824",
"bank_name": "PAYMONGO PAYMENTS, INC."
},
"reference_number": "X3veQ6EaqjUuQnsa3noU",
"sender": {
"bank_account_name": "Test business",
"bank_account_number": "779554303093",
"bank_code": "PAEYPHM2XXX",
"bank_id": "824",
"bank_name": "PAYMONGO PAYMENTS, INC."
},
"sender_email": null,
"status": "succeeded/failed/pending",
"type": "send\_payment",
"transfer_id": "tr_hn3hR2g7qYAZ6it23ptk5NqZ",
"created_at": 1753947245,
"updated_at": 1753947245
}
}
}
Updated about 11 hours ago