Create intent

Create a payment intent

Authorizations

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Idempotency-Key

string

Setting the idempotency key header to a unique value for each request ensures that transactions are never duplicated. Push recommends storing your internal transaction identifier in this field.

Body

application/json

redirect_url

string

The url to which the user will be redirected after completing the payment session.

If this parameter is omitted, the UX will use postMessage to notify the wrapping browser that the payment session has been completed.

webhook_url

string

The url to which Push will send a webhook notification when the intent is approved.

If this parameter is omitted, Push will use the default webhook URL registration for the operator.

approval_mode

enum<string>

How the intent should be approved and submitted for processing

Available options:

automatic,

manual

direction

enum<string>

required

Direction of the money flow, from the perspective of the Push Account

Available options:

cash_in,

cash_out

user_id

string

required

Push's unique identifier for the user

account_id

string

The settlement account which should be used for the transaction. If your program with Push utilizes multiple settlement accounts, this field is required to be set.

amount

integer

required

Amount for the transaction, in smallest unit of specified currency (ie if currency is USD, the unit would be cents)

currency

enum<string>

required

Currency associated with the amount

Available options:

USD

display_loyalty

boolean

Shows loyalty opt-in screen if set to true

display_limits

boolean

Shows request limits screen if set to true

Response

200 - application/json

url

string

required

The URL for the payment session