Skip to content

Create payout

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

Request Body schema

application/json

Field Type Required Description Example
endpoint string Yes Api key "53a90966-3640-486c-aa84-37aa8817abed"
amount integer Yes Amount in minor units 1000
currency integer Yes Number code 484
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
name string Yes The customer's name "John Smith"
email string Yes The customer's email "user@example.com"
country string No The customer's country (ISO 3166-1 alpha-2) "MX"
phone string No The customer's phone number in international format (E164) "+52999999999"
account_number string Yes The customer's card number "4000000000000077"
document_number string Yes The customer's official identification number assigned by a government authority "123"
document_type string Yes The customer's document type.
May be: CURP - Clave Única de Registro de Población/
RFC - Registro Federal Del Contribuyente		 "RFC"
bank_code string Yes The customer's bank code "97846"
bank_agency string No The customer's bank agency "string"
bank_name string No The customer's bank name "string"
payment_method string Yes Payment method.
May be: debit_card		 "debit_card"

Request sample

{
    "endpoint": "53a90966-3640-486c-aa84-37aa8817abed",
    "amount": 1000,
    "currency": 484,
    "buyer": {
        "remote_id": "string",
        "ip": "string"
    },
    "description": "string",
    "client_id": "string",
    "notify_url": "http://example.com",
    "name": "John Smith",
    "email": "user@example.com",
    "country": "MX",
    "phone": "+52999999999",
    "account_number": "4000000000000077",
    "document_number": "123",
    "document_type": "RFC",
    "bank_code": "97846",
    "bank_agency": "string",
    "bank_name": "string",
    "payment_method": "debit_card"
}

Response sample


STATUS 201

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