Refund errors

What are the errors associated with refunds?

Error Code

Reason

provider_processing_error

Provider is unavailable or refund error on our providers end.

resource_processing_state

There is an existing processing refund, this usually happens when you call create refund multiple times for a particular payment.

resource_processing_error

Unknown error on our end.

refund_not_allowed

Shopify transactions can only be refunded through their dashboard.

parameter_invalid

Refunds are not allowed for payments with source type.

resource_not_found

When payment does not exist

livemode_mismatched

Payment livemode/testmode does not match the authentication's mode

resource_failed_state

Only payment in paid state can be refunded

resource_disputed_state

The payment has been disputed by the cardholder

resource_pending_state
resource_processing_state

A previous refund request for this payment is still {processing|pending}

allowed_date_exceeded

Not allowed to refund a {payment method type} payment after {refundable days} days.

available_balance_insufficient

Refund amount is greater than the available payout amount.

parameter_above_maximum

The value of the amount is greater than {payment.amount}
or
Amount is greater than the remaining refundable value.
or
Only full amounts are allowed to be refunded for {GrabPay|PayMaya} payments.

parameter_below_minimum

The value for amount cannot be less than 1000
This is for stripe payments

payment_method_not_allowed

Please contact PayMongo with your transaction details to process your refund.
This is for card installment.

Next step: Retry the refund after the issue has been addressed, based on the reason for the error.

🚧

Due to system fixes, Union Bank of the Philippines (UBP) has temporarily disabled refunds for UBP online banking payments. Please process the refund directly to your customer outside the PayMongo platform. If you've already initiated the refund, contact [email protected] so our team can manually mark it as "failed."