Troubleshooting

This page covers the most common issues merchants and developers may encounter when using Payment Channels, along with recommended resolution steps.

If you see unexpected behavior, review this page first before opening a support ticket.

Payment Links

Webhook for payment status is not received

If you do not receive a payment status webhook from PayMongo, such as link.payment.paid, checkout_session.payment.paid, or payment.paid, you can still verify the payment manually.

What to do

Use the payment_id associated with the transaction and call the Retrieve Payment endpoint to confirm the latest payment status:

GET /v1/payments/:id

For the full endpoint reference, see Retrieve a Payment.

When to use this workaround

Use this approach when:

• a webhook has not been received yet
• you need to confirm whether a customer payment was successful
• you need a manual way to update payment status for Payment Links or Hosted Checkout

Important note

This is a temporary workaround for payment status verification. It can help you confirm and update the latest payment status for Links or Hosted Checkout flows, but it does not replace proper webhook handling.

If your issue is related to webhook delivery more broadly, refer to Troubleshooting Webhooks for further guidance.