Create Payout Order
2min
This API creates a payout order to enable users to withdraw funds. It accepts amount and currency details. On creating an order a dynamic token is returned from this api which is required to be passed to pay3Pay.openPayout()
This api requires access token that can be generated using Access Token API.
Create an order with payout details from application's backend
POST
Request Params
Header Parameters
signature
required
String
Signature generated with sha256 followed by base64 encoding. Check below section for more details
access-token
required
String
Access token received from Access token API. You can reuse the access token across multiple API calls till it is expired
Body Parameters
requestId
required
String
Identifier that is created by Application's backend. This will be passed in relevant events and webhooks from Pay3 to Application
currencyId
required
String
Currency id supported in the payout flow. This will be provided by Pay3 during onboarding
fiatAmount
required
String
Amount user can withdraw in string format. Maximum two decimal places are allowed
paymentMethodId
required
String
Unique string identifier. This will be provided by Pay3 during onboarding
email
required
String
User email to identify the user, which will be available in reporting dashboard
clientId
required
String
Client id. Application's identifier
firstName
optional
String
Optional first name of the user
lastName
optional
String
Optional last name of the user
taxId
optional
String
Tax ID issued to the user by their country
pixKey
optional
String
PIX Key is a unique identifier that links to a Brazilian user’s bank account and determines where the funds will be received.
The request for creating payout order requires a header signature. This can be generated using following javascript code snippet.
Updated 11 Sep 2024
Did this page help you?