Skip to main content
POST
Submit a payment action

Headers

Authorization
string
default:NONE
required

Bearer JWT for user-facing flows (Bearer eyJraWQ...), or the literal string NONE when authenticating via API key.

Example:

"Bearer eyJraWQ..."

X-Api-Key
string
default:NONE
required

API key for server-to-server flows, or the literal string NONE when authenticating via JWT.

Example:

"pcx_abc123_xxxx"

Path Parameters

payment_id
string
required

ID of the payment awaiting action.

Body

application/json
action
enum<string>
required

The action to perform on the pending payment.

Available options:
submit_otp,
verify,
cancel
action_data
object
required

Action-specific data. submit_otp requires reference and otp. verify requires reference.

Response

Action processed

statusCode
integer
Example:

200

response
object

When the provider returns funding instructions (for example a bank transfer flow), the instruction fields are merged into this object at the top level alongside the fields below.