Error codes

When the Global Acquiring API returns an error, search for its type, code, or message, then narrow the result by the endpoint you called. The table shows the first recommended action; expand a row only when you need more context.

How to use this page

Save the error details

Save the endpoint, HTTP status, complete response body, and request time. Do not include API keys, access tokens, PANs, or other sensitive card data in logs or support requests.

Search the response

Paste the complete type, code, or message into “Search response.” If more than one result remains, filter by operation name, operationId, HTTP method, or path.

Follow the recommended action

Confirm the Endpoint column, then follow the primary action. Expand “View details” for the reason, retry guidance, and conditions for contacting UQPAY.

Error response format

This product uses both typed error responses and compatibility formats without a type field. The same code can represent more than one message or condition, so do not identify an error from a single field alone.

Error code table

The type, code, and message columns preserve the values returned by the API. Endpoint entries include the operation name, operationId, HTTP method, and path. Dynamic messages are represented by a confirmed stable pattern or description.

Before contacting UQPAY, prepare the HTTP method and path, x-response-id, request time, and complete error response. Remove API keys, access tokens, PANs, and other sensitive information. Each row lists only the additional information needed for that error.

HTTP / Type	Code / Message	Endpoint	Recommended action
401 `unauthorized_error`	`unauthorized_error` `auth token is not empty`	All public endpoints	Refresh authentication Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The authentication details are missing, expired, or invalid. Retry: Retry after correcting the request or resource state.
401 `unauthorized_error`	`unauthorized_error` `invalid auth token format`	All public endpoints	Refresh authentication Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The authentication details are missing, expired, or invalid. Retry: Retry after correcting the request or resource state.
401 `unauthorized_error`	`unauthorized_error` `auth token is illegal`	All public endpoints	Refresh authentication Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The authentication details are missing, expired, or invalid. Retry: Retry after correcting the request or resource state.
401 `unauthorized_error`	`unauthorized_error` `auth token is expired`	All public endpoints	Refresh authentication Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The authentication details are missing, expired, or invalid. Retry: Retry after correcting the request or resource state.
401 `unauthorized_error`	`unauthorized_error` `invalid auth token request`	All public endpoints	Refresh authentication Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The authentication details are missing, expired, or invalid. Retry: Retry after correcting the request or resource state.
400 `idempotency_error`	`invalid idempotency key format` `Idempotency key is invalid`	Applies to 13 public endpoints	Check the balance Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The available balance or currency does not meet the operation requirements. Retry: Retry after correcting the request or resource state.
500 `api_error`	`api_error` `An internal error occurred, please try again.`	Applies to 13 public endpoints	Check the balance Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The available balance or currency does not meet the operation requirements. Retry: Retry after correcting the request or resource state.
400 Legacy flat	`200` `Request is processing, please try again later.`	Applies to 13 public endpoints	Check the balance Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The available balance or currency does not meet the operation requirements. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, Amount`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `account_error`	`account_not_found` `Account not found or deactivated`	All public endpoints	Verify the resource Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The resource is missing, unavailable, or does not belong to the current account. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_return_url` `Invalid return url`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_description` `Invalid description`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_order_amount` `Invalid order amount`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_order_currency` `Invalid order currency`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_payment_orders` `Invalid payment orders`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_payment_method` `timezone is invalid`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent` Update a PaymentIntent `POST /v2/payment_intents/{id}` operationId: `update-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`payment_link_not_found` `Payment link not found`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Verify the resource Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The resource is missing, unavailable, or does not belong to the current account. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`payment_link_inactive` `This link can no longer accept payments. Contact the seller for more information.`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`payment_link_expired` `This link can no longer accept payments. Contact the seller for more information.`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Refresh authentication Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The authentication details are missing, expired, or invalid. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`payment_link_access_number_not_enough` `This link can no longer accept payments. Contact the seller for more information.`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`payment_link_parameters_error` `Payment link parameters error`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `product_error`	`product_not_found` `Product not found or inactive`	Applies to 5 public endpoints	Verify the resource Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The resource is missing, unavailable, or does not belong to the current account. Retry: Retry after correcting the request or resource state.
400 `api_error`	`require_payment_pii` `invalid payer identifier`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`create_payment_intent_failed` `Create payment intent failed`	Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`create_payment_attempt_failed` `Create payment attempt failed`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`confirm_payment_intent_failed` `Confirm payment intent failed`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`retrieve_payment_intent_failed` `Retrieve payment intent failed`	Applies to 6 public endpoints	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `api_error`	`3ds_required` `invalid three_ds_action parameter`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`applepay_invalid_token` `Apple Pay token verification failed`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`applepay_decrypt_failed` `Apple Pay token decryption failed`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`applepay_decrypt_failed` `apple pay configuration is invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `account_error`	`account_configuration_invalid` `payment configuration is invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `account_error`	`account_configuration_invalid` `account channel reference_store_id is required`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `api_error`	`invalid_currency` `Invalid currency`	Applies to 5 public endpoints	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[mcc]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient_sender_details]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[fund_source]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `fund_source invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.first_name]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.first_name invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.street]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.street invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.last_name]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.last_name invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.city]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.city invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.state]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.state invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.country_code]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.country_code invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.postcode]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.postcode invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.birth]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.birth invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[recipient.account_number]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `recipient.account_number invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[sender]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[sender.first_name]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `sender.first_name invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[sender.last_name]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `sender.last_name`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[sender.birth]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `sender.birth invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[sender.street]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `sender.street invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[sender.city]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `sender.city invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[sender.state]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `sender.state invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `missing necessary parameters[sender.country_code]`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `sender.country_code invalid`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `parameter is invalid`	Applies to 8 public endpoints	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`not_found_id` `Not Found ID`	Retrieve a PaymentAttempt `GET /v2/payment/payment_attempts/{id}` operationId: `retrieve-payment-attempt` Retrieve a PaymentIntent `GET /v2/payment_intents/{id}` operationId: `retrieve-payment-intent`	Verify the resource Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The resource is missing, unavailable, or does not belong to the current account. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, Description`	Update a PaymentIntent `POST /v2/payment_intents/{id}` operationId: `update-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`invalid_order_status` `Invalid order status`	Applies to 4 public endpoints	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`expired_order` `Expired payment intent`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Update a PaymentIntent `POST /v2/payment_intents/{id}` operationId: `update-payment-intent`	Refresh authentication Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The authentication details are missing, expired, or invalid. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Invalid request parameters`	Register Terminal `POST /v2/terminal/register` operationId: `register-terminal` Update a PaymentIntent `POST /v2/payment_intents/{id}` operationId: `update-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`update_payment_intent_failed` `Update payment intent failed`	Update a PaymentIntent `POST /v2/payment_intents/{id}` operationId: `update-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`confirm_payment_intent_failed` `amount is inconsistent with payment intent`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `invalid_request_error`	`invalid_payment_method` `invalid payment consent`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, AmountToCapture`	Capture a PaymentIntent `POST /v2/payment_intents/{id}/capture` operationId: `capture-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`repeat_payment_request` `Operation failed. Payment request has been completed for the order. No need to repeat operation.`	Capture a PaymentIntent `POST /v2/payment_intents/{id}/capture` operationId: `capture-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`retrieve_payment_attempt_failed` `Retrieve payment attempt failed`	Cancel a PaymentIntent `POST /v2/payment_intents/{id}/cancel` operationId: `cancel-payment-intent` Capture a PaymentIntent `POST /v2/payment_intents/{id}/capture` operationId: `capture-payment-intent` Create a refund `POST /v2/payment/refunds` operationId: `create-refund`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`capture_amount_invalid` `Amount requested is inconsistent with order amount, Please enter the correct amount.`	Capture a PaymentIntent `POST /v2/payment_intents/{id}/capture` operationId: `capture-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`capture_payment_intent_failed` `Capture payment intent failed`	Capture a PaymentIntent `POST /v2/payment_intents/{id}/capture` operationId: `capture-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, CancellationReason`	Cancel a PaymentIntent `POST /v2/payment_intents/{id}/cancel` operationId: `cancel-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`order_cancelled` `Order cancelled`	Cancel a PaymentIntent `POST /v2/payment_intents/{id}/cancel` operationId: `cancel-payment-intent`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`invalid_order_status` `Payment is awaiting 3DS authentication, please wait for completion or expiry before cancelling`	Cancel a PaymentIntent `POST /v2/payment_intents/{id}/cancel` operationId: `cancel-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`retrieve_refund_failed` `Retrieve refund failed`	Cancel a PaymentIntent `POST /v2/payment_intents/{id}/cancel` operationId: `cancel-payment-intent` Create a refund `POST /v2/payment/refunds` operationId: `create-refund` Retrieve a refund `GET /v2/payment/refunds/{id}` operationId: `retrieve-refund`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`operation_pending` `Operation pending! Do not repeat submissions!`	Cancel a PaymentIntent `POST /v2/payment_intents/{id}/cancel` operationId: `cancel-payment-intent`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`cancel_payment_intent_failed` `Cancel payment intent failed`	Cancel a PaymentIntent `POST /v2/payment_intents/{id}/cancel` operationId: `cancel-payment-intent`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, PaymentIntentId`	Create a refund `POST /v2/payment/refunds` operationId: `create-refund`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `refund_error`	`refund_amount_invalid` `Refund amount invalid`	Create a refund `POST /v2/payment/refunds` operationId: `create-refund`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `refund_error`	`refund_amount_exceeded` `Refund amount exceeded original transaction amount`	Create a refund `POST /v2/payment/refunds` operationId: `create-refund`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `refund_error`	`refund_processing` `Refund is processing, please try again after`	Create a refund `POST /v2/payment/refunds` operationId: `create-refund`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `refund_error`	`refund_stat_failed` `Find refund order failed`	Create a refund `POST /v2/payment/refunds` operationId: `create-refund`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `payment_error`	`operation_pending` `The payment is still being updated. Please try again later.`	Create a refund `POST /v2/payment/refunds` operationId: `create-refund`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `refund_error`	`create_refund_failed` `Create refund failed`	Create a refund `POST /v2/payment/refunds` operationId: `create-refund`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `invalid_request_error`	`invalid_parameter` `invalid start_time`	List all refunds `GET /v2/payment/refunds` operationId: `list-refunds`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `invalid end_time`	List all refunds `GET /v2/payment/refunds` operationId: `list-refunds`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `the end_time cannot be earlier than the start_time`	List all refunds `GET /v2/payment/refunds` operationId: `list-refunds`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `the start_time and end_time cannot differ by more than 90 days`	List all refunds `GET /v2/payment/refunds` operationId: `list-refunds`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, PageNumber`	List Balances `GET /v2/payment/balances` operationId: `list-balances` List all Bank Accounts `GET /v2/payment/bankaccount` operationId: `list-bank-accounts` List all Payouts `GET /v2/payment/payout` operationId: `list-payouts`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, PayoutCurrency`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, PayoutAmount`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payout_error`	`create_payout_failed` `Create payout failed`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `api_error`	`disabled_transfer_type` `This type of payout is disabled by the merchant (e.g., auto-withdrawal turned off)`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `api_error`	`merchant_account_invalid` `Merchant Account Invalid`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payout_error`	`payout_settlement_account_not_found` `No account settlement for this currency`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `api_error`	`insufficient_balance` `Merchant’s available balance is insufficient`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Check the balance Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The available balance or currency does not meet the operation requirements. Retry: Retry after correcting the request or resource state.
429 `api_error`	`velocity_limit_exceeded` `Transaction frequency/amount exceeds risk control thresholds (e.g., more than 5 payouts within 1 hour)`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Reduce the request rate Stop frequent retries. Wait briefly, then retry with exponential backoff. View details Why this happened: The request or operation rate is above the current limit. Retry: Retry with exponential backoff; stop and contact UQPAY if the error persists.
400 `payout_error`	`payout_not_found` `payout not found`	Retrieve Payout `GET /v2/payment/payout/{payout_id}` operationId: `retrieve-payout`	Verify the resource Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The resource is missing, unavailable, or does not belong to the current account. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`internal_error` `Internal Error: Please contact support for assistance`	Create Bank Account `POST /v2/payment/bankaccount/create` operationId: `create-bank-account` List all Bank Accounts `GET /v2/payment/bankaccount` operationId: `list-bank-accounts` List all Payouts `GET /v2/payment/payout` operationId: `list-payouts`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, Currency`	Create Bank Account `POST /v2/payment/bankaccount/create` operationId: `create-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `bank_code_type ‘aba’ is required when currency is ‘USD’ and bank_country_code is ‘US’`	Create Bank Account `POST /v2/payment/bankaccount/create` operationId: `create-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `api_error`	`invalid_currency` `Currency not supported`	Create Bank Account `POST /v2/payment/bankaccount/create` operationId: `create-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `account_error`	`bank_account_already_exists` `Bank account already exists for this currency`	Create Bank Account `POST /v2/payment/bankaccount/create` operationId: `create-bank-account`	Avoid duplicate submission Retry only after the condition identified by the message has been resolved. View details Why this happened: The same request or resource may already exist or still be processing. Retry: Retry only when the returned condition has been resolved and the operation permits it.
400 `account_error`	`create_bank_account_failed` `Create bank account failed`	Create Bank Account `POST /v2/payment/bankaccount/create` operationId: `create-bank-account`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `account_error`	`bank_account_not_found` `Bank account not found`	Retrieve Bank Account `GET /v2/payment/bankaccount/{id}` operationId: `retrieve-bank-account` Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Verify the resource Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The resource is missing, unavailable, or does not belong to the current account. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, AccountNumber`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, BankName`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, SwiftCode`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, BankCountryCode`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, BankAddress`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, BankBranchCode`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, BankCodeValue`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, BankCodeType`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `bank_code_value is required when bank_code_type is provided`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `account_error`	`update_bank_account_failed` `Update bank account failed`	Update Bank Account `POST /v2/payment/bankaccount/{id}` operationId: `update-bank-account`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, FirmNo`	Register Terminal `POST /v2/terminal/register` operationId: `register-terminal`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `api_error`	`account_pos_api_no_permission` `Account pos api no permission`	Get PIN Key `POST /v2/terminal/getPinKey` operationId: `get-pin-key` Register Terminal `POST /v2/terminal/register` operationId: `register-terminal`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `Mandatory parameter is missing`	Register Terminal `POST /v2/terminal/register` operationId: `register-terminal`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `api_error`	`terminal_register_failed` `Terminal register failed`	Register Terminal `POST /v2/terminal/register` operationId: `register-terminal`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `api_error`	`terminal_not_belong_to_account` `Terminal not belong to account`	Get PIN Key `POST /v2/terminal/getPinKey` operationId: `get-pin-key` Register Terminal `POST /v2/terminal/register` operationId: `register-terminal`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_parameter` `Request parameters invalid, TerminalId`	Get PIN Key `POST /v2/terminal/getPinKey` operationId: `get-pin-key`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `api_error`	`terminal_info_not_found` `Terminal info not found`	Get PIN Key `POST /v2/terminal/getPinKey` operationId: `get-pin-key`	Verify the resource Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The resource is missing, unavailable, or does not belong to the current account. Retry: Retry after correcting the request or resource state.
400 `api_error`	`pinkey_retrieve_failed` `Pinkey retrieve failed`	Get PIN Key `POST /v2/terminal/getPinKey` operationId: `get-pin-key`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
429 `api_error`	`velocity_limit_exceeded` `The payout amount is less than the minimum payout threshold, and therefore cannot be processed.`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Check the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: A request parameter, resource state, or account setting does not allow this operation. Retry: Retry after correcting the request or resource state.
400 `payout_error`	`create_payout_failed` `Failed to calculate payout amounts`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Retry later Retry only after the condition identified by the message has been resolved. View details Why this happened: The request could not be completed and changing request parameters alone may not resolve it. Retry: Retry only when the returned condition has been resolved and the operation permits it. When to contact UQPAY: Contact UQPAY if the same error persists after the recommended action and limited retries. Also provide: x-response-id, request time, HTTP method and path, complete error response.
400 `api_error`	`insufficient_balance` `Insufficient account balance`	Create Payout `POST /v2/payment/payout/create` operationId: `create-payout`	Check the balance Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The available balance or currency does not meet the operation requirements. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `account id is required`	Register Terminal `POST /v2/terminal/register` operationId: `register-terminal`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `short account id is required`	Register Terminal `POST /v2/terminal/register` operationId: `register-terminal`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`missing_parameter` `account name is required`	Register Terminal `POST /v2/terminal/register` operationId: `register-terminal`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `api_error`	`require_payment_pii` `invalid payment method body`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `api_error`	`require_payment_pii` `invalid payer info`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `payment_error`	`operation_in_progress` `Saved card setup is still in progress. Please retry after the current payment is completed.`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.
400 `invalid_request_error`	`invalid_payment_method` `This card is already saved for the customer.`	Confirm a PaymentIntent `POST /v2/payment_intents/{id}/confirm` operationId: `confirm-payment-intent` Create a PaymentIntent `POST /v2/payment_intents/create` operationId: `create-payment-intent`	Correct the request Correct the request or resource identified by the message and API Reference, then retry. View details Why this happened: The request does not meet an endpoint parameter or business rule. Retry: Retry after correcting the request or resource state.

Getting Started

Accept Payments

Manage Payments

Testing

Reference

How to use this page

Error response format

Error code table

​How to use this page

​Error response format

​Error code table

​Related documentation

How to use this page

Error response format

Error code table

Related documentation