Skip to main content
All error responses follow the standard error format. Validation errors (422) and rate limit errors (429) apply to all endpoints and are documented in the Error Handling guide.
CodeStatusMessage
IDEMPOTENCY_KEY_REQUIRED400An idempotency key is required for payment creation.
INVALID_TIMESTAMP_FORMAT400Invalid timestamp format. Expected RFC3339 format (e.g., 2024-01-15T10:30:00Z).
PAYMENT_INVALID_RECIPIENT400Invalid recipient format. Please check the email, phone, or party ID.
PAYMENT_RECIPIENT_INVALID400Please provide exactly one recipient (email, phone, or party ID).
PAYMENT_VALIDATION_FAILED400Payment validation failed. Please check your request.
INVALID_TOKEN401Invalid or expired token.
NOT_AUTHENTICATED401Authentication required.
INSUFFICIENT_PERMISSIONS403You don’t have permission to perform this action.
RESOURCE_NOT_FOUND404The requested resource was not found.
PAYMENT_CREATION_FAILED500Failed to create payment. Please try again.
TRANSACTION_SERVICE_ERROR500Unable to retrieve transaction information. Please try again.
PAYMENT_SERVICE_ERROR502Payment service error. Please try again later.