Create card payin

curl --request POST \
  --url https://sandbox-revo-api.raliopay.com/api/v1/account/users/{uid}/accounts/{aid}/card-payins \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 5000,
  "currency": "EUR",
  "reference": "CARD-PAY-2025-001234",
  "urlFailed": "https://example.com/payment/failed",
  "urlSuccess": "https://example.com/payment/success",
  "payer": {
    "address": "123 Main Street",
    "birthdate": "1990-05-15T00:00:00.000Z",
    "city": "Madrid",
    "country": "ES",
    "documentNumber": "12345678A",
    "documentType": "NATIONAL_ID",
    "email": "[email protected]",
    "name": "John",
    "phone": "+34612345678",
    "postalCode": "28001",
    "surname": "Doe"
  }
}
'

{
  "order": {
    "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"
  },
  "paymentUrl": "https://payment-gateway.example.com/pay/abc123"
}

POST

api

account

users

{uid}

accounts

{aid}

card-payins

Create card payin

curl --request POST \
  --url https://sandbox-revo-api.raliopay.com/api/v1/account/users/{uid}/accounts/{aid}/card-payins \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 5000,
  "currency": "EUR",
  "reference": "CARD-PAY-2025-001234",
  "urlFailed": "https://example.com/payment/failed",
  "urlSuccess": "https://example.com/payment/success",
  "payer": {
    "address": "123 Main Street",
    "birthdate": "1990-05-15T00:00:00.000Z",
    "city": "Madrid",
    "country": "ES",
    "documentNumber": "12345678A",
    "documentType": "NATIONAL_ID",
    "email": "[email protected]",
    "name": "John",
    "phone": "+34612345678",
    "postalCode": "28001",
    "surname": "Doe"
  }
}
'

{
  "order": {
    "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"
  },
  "paymentUrl": "https://payment-gateway.example.com/pay/abc123"
}

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

Funding details

amount

integer

required

Example:

5000

currency

enum<string>

required

Available options:

EUR,

USD

Example:

"EUR"

reference

string

required

Example:

"CARD-PAY-2025-001234"

urlFailed

string

required

Example:

"https://example.com/payment/failed"

urlSuccess

string

required

Example:

"https://example.com/payment/success"

payer

object

Show child attributes

payer.address

string

required

Example:

"123 Main Street"

payer.birthdate

string

required

Example:

"1990-05-15T00:00:00.000Z"

payer.city

string

required

Example:

"Madrid"

payer.country

string

required

Example:

"ES"

payer.documentNumber

string

required

Example:

"12345678A"

payer.documentType

enum<string>

required

Available options:

NATIONAL_ID,

RESIDENCE_CARD,

PASSPORT,

DRIVING_LICENSE,

CIF

Example:

"NATIONAL_ID"

payer.email

string

required

Example:

"[email protected]"

payer.name

string

required

Example:

"John"

payer.phone

string

required

Example:

"+34612345678"

payer.postalCode

string

required

Example:

"28001"

payer.surname

string

required

Example:

"Doe"

Response

Created

order

object

Show child attributes

order.createdAt

string

Example:

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

order.destination

object

Show child attributes

order.destination.currency

enum<string>

required

USD, EUR, etc.

Available options:

EUR,

USD

Example:

"EUR"

order.destination.amount

integer

Amount in cents. Ex: 12345 = 123.45€

Example:

1000

order.detailUrl

string

Example:

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

order.displayType

string

Example:

"Transaction Type"

order.failedAt

string

Example:

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

order.fee

object

Show child attributes

order.fee.currency

enum<string>

required

USD, EUR, etc.

Available options:

EUR,

USD

Example:

"EUR"

order.fee.amount

integer

Amount in cents. Ex: 12345 = 123.45€

Example:

1000

order.fx

object

Show child attributes

order.fx.pair

string

Example:

"EUR/USD"

order.fx.rate

number

Example:

1.08

order.fx.timestamp

string

Example:

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

order.id

string

Example:

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

order.origin

object

Show child attributes

order.origin.currency

enum<string>

required

USD, EUR, etc.

Available options:

EUR,

USD

Example:

"EUR"

order.origin.amount

integer

Amount in cents. Ex: 12345 = 123.45€

Example:

1000

order.reference

string

Example:

"PAY-2025-001234"

order.settledAt

string

Example:

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

order.state

string

Example:

"PENDING"

order.type

string

Example:

"TRANSACTION_TYPE"

order.updatedAt

string

Example:

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

paymentUrl

string

Example:

"https://payment-gateway.example.com/pay/abc123"

Get account transfer capabilities Get bank payin order details

⌘I

Getting started

Authentication

Users

User verification

Accounts

Account capabilities

Pay In

Pay Out

Transfers

Transactions

Orders

Create card payin

Authorizations

Path Parameters

Body

Response