Create bank payout

curl --request POST \
  --url https://sandbox-revo-api.raliopay.com/api/v1/account/users/{uid}/accounts/{aid}/bank-payouts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code2fa": "123456",
  "description": "Payment for services rendered",
  "origin": {
    "currency": "EUR",
    "amount": 1000
  },
  "recipient": {
    "accountNumber": "ES9121000418450200051332",
    "address": "Calle Gran Via 123",
    "beneficiaryType": "PERSON",
    "city": "Barcelona",
    "country": "ES",
    "currency": "EUR",
    "documentNumber": "87654321B",
    "name": "Maria",
    "postalCode": "08001",
    "routingData": "IBAN",
    "documentType": "NATIONAL_ID",
    "phone": "+34612345678",
    "relation": "FRIEND",
    "surname": "Garcia"
  },
  "reference": "PAY-2025-001234"
}
'

{
  "createdAt": "2025-01-15T10:30:00.000Z",
  "destination": {
    "currency": "EUR",
    "amount": 1000
  },
  "detailUrl": "/api/v1/account/orders/e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b",
  "displayType": "Transaction Type",
  "failedAt": "2025-01-15T10:35:00.000Z",
  "fee": {
    "currency": "EUR",
    "amount": 1000
  },
  "fx": {
    "pair": "EUR/USD",
    "rate": 1.08,
    "timestamp": "2025-01-15T10:30:00.000Z"
  },
  "id": "e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b",
  "origin": {
    "currency": "EUR",
    "amount": 1000
  },
  "reference": "PAY-2025-001234",
  "settledAt": "2025-01-15T10:35:00.000Z",
  "state": "PENDING",
  "type": "TRANSACTION_TYPE",
  "updatedAt": "2025-01-15T10:30:05.000Z"
}

POST

api

account

users

{uid}

accounts

{aid}

bank-payouts

Create bank payout

curl --request POST \
  --url https://sandbox-revo-api.raliopay.com/api/v1/account/users/{uid}/accounts/{aid}/bank-payouts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code2fa": "123456",
  "description": "Payment for services rendered",
  "origin": {
    "currency": "EUR",
    "amount": 1000
  },
  "recipient": {
    "accountNumber": "ES9121000418450200051332",
    "address": "Calle Gran Via 123",
    "beneficiaryType": "PERSON",
    "city": "Barcelona",
    "country": "ES",
    "currency": "EUR",
    "documentNumber": "87654321B",
    "name": "Maria",
    "postalCode": "08001",
    "routingData": "IBAN",
    "documentType": "NATIONAL_ID",
    "phone": "+34612345678",
    "relation": "FRIEND",
    "surname": "Garcia"
  },
  "reference": "PAY-2025-001234"
}
'

{
  "createdAt": "2025-01-15T10:30:00.000Z",
  "destination": {
    "currency": "EUR",
    "amount": 1000
  },
  "detailUrl": "/api/v1/account/orders/e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b",
  "displayType": "Transaction Type",
  "failedAt": "2025-01-15T10:35:00.000Z",
  "fee": {
    "currency": "EUR",
    "amount": 1000
  },
  "fx": {
    "pair": "EUR/USD",
    "rate": 1.08,
    "timestamp": "2025-01-15T10:30:00.000Z"
  },
  "id": "e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b",
  "origin": {
    "currency": "EUR",
    "amount": 1000
  },
  "reference": "PAY-2025-001234",
  "settledAt": "2025-01-15T10:35:00.000Z",
  "state": "PENDING",
  "type": "TRANSACTION_TYPE",
  "updatedAt": "2025-01-15T10:30:05.000Z"
}

Authorizations

Authorization

string

header

required

API Key for accessing management endpoints

Path Parameters

uid

string

required

User ID

aid

string

required

Account ID

Body

application/json

Payout details

code2fa

string

required

Example:

"123456"

description

string

required

Example:

"Payment for services rendered"

origin

object

required

Show child attributes

origin.currency

enum<string>

required

USD, EUR, etc.

Available options:

EUR,

USD

Example:

"EUR"

origin.amount

integer

Amount in cents. Ex: 12345 = 123.45€

Example:

1000

recipient

object

required

Show child attributes

recipient.accountNumber

string

required

Example:

"ES9121000418450200051332"

recipient.address

string

required

Example:

"Calle Gran Via 123"

recipient.beneficiaryType

enum<string>

required

Beneficiary Type. Possible values: PERSON, BUSINESS required: true example: PERSON

Available options:

PERSON,

BUSINESS

Example:

"PERSON"

recipient.city

string

required

Example:

"Barcelona"

recipient.country

string

required

Example:

"ES"

recipient.currency

string

required

Example:

"EUR"

recipient.documentNumber

string

required

Example:

"87654321B"

recipient.name

string

required

Example:

"Maria"

recipient.postalCode

string

required

Example:

"08001"

recipient.routingData

enum<string>

required

Available options:

IBAN

Example:

"IBAN"

recipient.documentType

enum<string>

Available options:

NATIONAL_ID,

RESIDENCE_CARD,

PASSPORT,

DRIVING_LICENSE,

CIF

Example:

"NATIONAL_ID"

recipient.phone

string

Example:

"+34612345678"

recipient.relation

string

Example:

"FRIEND"

recipient.surname

string

Example:

"Garcia"

reference

string

required

Example:

"PAY-2025-001234"

Response

Created

createdAt

string

Example:

"2025-01-15T10:30:00.000Z"

destination

object

Show child attributes

destination.currency

enum<string>

required

USD, EUR, etc.

Available options:

EUR,

USD

Example:

"EUR"

destination.amount

integer

Amount in cents. Ex: 12345 = 123.45€

Example:

1000

detailUrl

string

Example:

"/api/v1/account/orders/e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b"

displayType

string

Example:

"Transaction Type"

failedAt

string

Example:

"2025-01-15T10:35:00.000Z"

fee

object

Show child attributes

fee.currency

enum<string>

required

USD, EUR, etc.

Available options:

EUR,

USD

Example:

"EUR"

fee.amount

integer

Amount in cents. Ex: 12345 = 123.45€

Example:

1000

object

Show child attributes

fx.pair

string

Example:

"EUR/USD"

fx.rate

number

Example:

1.08

fx.timestamp

string

Example:

"2025-01-15T10:30:00.000Z"

string

Example:

"e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b"

origin

object

Show child attributes

origin.currency

enum<string>

required

USD, EUR, etc.

Available options:

EUR,

USD

Example:

"EUR"

origin.amount

integer

Amount in cents. Ex: 12345 = 123.45€

Example:

1000

reference

string

Example:

"PAY-2025-001234"

settledAt

string

Example:

"2025-01-15T10:35:00.000Z"

state

string

Example:

"PENDING"

type

string

Example:

"TRANSACTION_TYPE"

updatedAt

string

Example:

"2025-01-15T10:30:05.000Z"

Get card payin order details Get bank payout order details

⌘I

Getting started

Authentication

Users

User verification

Accounts

Account capabilities

Pay In

Pay Out

Transfers

Transactions

Orders

Create bank payout

Authorizations

Path Parameters

Body

Response