Skip to main content
POST
/
customers
/
transfer
Billetera a billetera
curl --request POST \
  --url https://api.onepay.la/v1/customers/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency: <x-idempotency>' \
  --data '
{
  "origin": "<string>",
  "destination": "<string>",
  "amount": "<string>",
  "concept": "<string>",
  "external_id": "<string>"
}
'
{
  "id": "0194b9a9-45e4-73c5-8139-44d3813d8f29",
  "type": "withdraw",
  "amount": -1000,
  "label": "$1.000",
  "concept": "Prueba",
  "subtype": "WALLET_TRANSFER",
  "confirmed": true,
  "node_type": null,
  "created_at": "2025-01-31",
  "external_id": "ref-001",
  "node": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.onepay.la/llms.txt

Use this file to discover all available pages before exploring further.

Headers

x-idempotency
string
required
Token único para garantizar la idempotencia de la petición

Body

origin
string
required
Wallet ID de la billetera que enviará el dinero
destination
string
required
Wallet ID de la billetera que recibirá el dinero
amount
string
required
Monto a enviar
concept
string
Descripción de la transacción
external_id
string
Identificador externo opcional (máx. 255 caracteres). Si lo envías, se guarda en la transacción y se devuelve tal cual en el webhook wallet.transaction.created, lo que te permite correlacionar la transferencia con tus registros internos.
{
  "id": "0194b9a9-45e4-73c5-8139-44d3813d8f29",
  "type": "withdraw",
  "amount": -1000,
  "label": "$1.000",
  "concept": "Prueba",
  "subtype": "WALLET_TRANSFER",
  "confirmed": true,
  "node_type": null,
  "created_at": "2025-01-31",
  "external_id": "ref-001",
  "node": null
}