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

StatusMeaning
SucceededTransaction was successful.
PendingTransaction is still processing. For Instapay, allow 20 minutes to finalize. For Pesonet, allow 1 day to have a final status.
FailedTransaction 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
		}
	}
}