Skip to content

Create payout

POST api/v2/paygate/payout/wallet/
Create a payout by wallet

Request Body schema

application/json

Field Type Required Description Example
endpoint string Yes Api key "1dc4441f-38d5-42b5-a705-81958f928462"
amount integer Yes Amount in minor units 1000
currency integer Yes Number code 978
buyer object Yes Buyer at the endpoint in JSON format {"remote_id": "string", "ip": "string"}
description string No Description "string"
client_id string No Transaction id at the endpoint.
Max 255 chars
"string"
notify_url string or null No Notification URL of changed status "http://example.com"
moderated boolean or null No Is payout moderated? Default: True True
payment_method string or null No The method of payment being used for the transaction.
Used for some types of withdrawals.
"string"
name string No The customer's name.
Used for some types of withdrawals.
"John Smith"
email string No The customer's email.
Used for some types of withdrawals.
"user@example.com"
phone string No The customer's phone number.
Used for some types of withdrawals.
"string"
country string No The customer's country code.
Used for some types of withdrawals. (ISO 3166-1 alpha-2)
"string"
account_number string No The customer's account number.
Used for some types of withdrawals.(Wallet number, Bank account number, VPA...)
"12312312312"
bank_account_type string No The customer's bank account type.
Used for some types of withdrawals.
May be: SAVINGS, CHECKING
"string"
bank_code string No The customer's bank code.
Used for some types of withdrawals.
"0001"
bank_name string No The customer's bank name.
Used for some types of withdrawals.
"string"
bank_agency string No The customer's bank agency.
Used for some types of withdrawals.
"string"
bank_account_number string No The customer's bank account number.
Used for some types of withdrawals.
"12312312312"
first_name string No The customer's first name.
Used for some types of withdrawals.
"John"
last_name string No The customer's last name.
Used for some types of withdrawals.
"Smith"
city string No The customer's city.
Used for some types of withdrawals.
"string"
address string No The customer's address.
Used for some types of withdrawals.
"123 Main Street, Apt 4B"
holder string No The customer's holder.
Used for some types of withdrawals.
"string"
document_number string No The customer's document number.
Used for some types of withdrawals.
"111111111"
document_type string No The customer's document type.
Used for some types of withdrawals.
"string"
sort_code string No The customer's sort_code (FPS).
Used for some types of withdrawals.
"string"
evp_random_key string No The customer's EVP random key.
Used for some types of withdrawals.
"string"

Request sample

{
    "endpoint": "1dc4441f-38d5-42b5-a705-81958f928462",
    "amount": 1000,
    "currency": 978,
    "buyer": {
        "remote_id": "string",
        "ip": "string"
    },
    "description": "string",
    "client_id": "string",
    "notify_url": "http://example.com",
    "payment_method": "string",
    "name": "John Smith",
    "email": "user@example.com",
    "phone": "string",
    "country": "string",
    "account_number": "12312312312",
    "bank_account_type": "string",
    "bank_code": "0001",
    "bank_name": "string",
    "bank_agency": "string",
    "bank_account_number": "12312312312",
    "first_name": "John",
    "last_name": "Smith",
    "holder": "string",
    "city": "string",
    "address": "123 Main Street, Apt 4B",
    "document_number": "111111111",
    "document_type": "string",
    "sort_code": "string",
    "evp_random_key": "string"
}

Response sample


STATUS 201

{
    "tx": {
        "tx": "f17d7f5c-6b4a-47fd-95eb-08086e250473",
        "payout": {},
        "status": "create",
        "currency": {
          "id": 0,
          "title": "Euro",
          "char_code": "EUR",
          "num_code": 978
        },
        "amount": 1000,
        "created_at": "2000-01-01T00:00:00Z",
        "errors": {},
        "parts_tx": [],
        "additional_data": {},
        "endpoint_logo": "string"
    }
}