Skip to main content
POST
/
accounts
curl https://api.onepay.la/v1/accounts \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: account-001" \
  -d '{
    "subtype": "SAVINGS",
    "authorization": true,
    "re-enrollment": false,
    "account_number": "1234567890",
    "customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
    "bank_id": "9957817c-f17e-472b-b531-e3d1490bf757"
  }'

{
   "id":"84cc072e-90e8-33cf-9305-098095fed32f",
   "title":"Ms.",
   "subtype":"CHECKING",
   "status":"PENDING",
   "authorization":true,
   "customer_id":"9e01d019-b438-40d2-89e1-52430c69dfb7",
   "re_enroll":false,
   "external_id":null,
   "bank_id":"9e01d019-b731-48bc-b111-2baa3ea56ef6",
   "bank":{
      "id":"9e01d019-b731-48bc-b111-2baa3ea56ef6",
      "name":"Maggio-Hills",
      "logo":null,
      "base64_logo":""
   },
   "customer":{
      "id":"9e01d019-b438-40d2-89e1-52430c69dfb7",
      "first_name":"Izaiah",
      "last_name":"Rogahn",
      "email":"",
      "phone":"+17478695836",
      "document_type":"CC",
      "document_number":"156762",
      "created_at":"2025-01-19T17:03:55.000000Z",
      "is_test":true
   }
}

​
Headers

​
x-idempotency
string
required
Token único para garantizar la idempotencia de la petición
El parámetro authorization debe ser true. Sin esto, la cuenta se crea pero el usuario nunca recibe la solicitud de enrolamiento en su billetera y no podrás realizar cargos.
​
subtype
string
required
Tipo de cuenta bancaria [SAVINGS, CHECKING, ELECTRONIC_DEPOSIT, KEY(Bre-B)]
​
authorization
boolean
required
Indica si el usuario ha autorizado débitos automáticos para esta cuenta.
​
re-enrollment
boolean
required
Indica si es una re-vinculación de una cuenta que ya existió previamente. Útil para rastrear cuentas que fueron eliminadas y vueltas a crear.
​
account_number
string
required
Número de cuenta bancaria, si es cuenta de Bre-B alfa numérica debe empezar con @
​
external_id
string
Identificador único del cliente.
​
bank_id
string
Identificador único del banco [requerido si el tipo de cuenta es SAVINGS o CHECKING]
​
customer_id
string
required
ID del cliente dueño de la cuenta. Crear cliente.
​
related_to
string
ID del cliente relacionado (opcional). Útil para vincular cuentas de familiares, socios o representantes autorizados al cliente principal.
{
   "id":"84cc072e-90e8-33cf-9305-098095fed32f",
   "title":"Ms.",
   "subtype":"CHECKING",
   "status":"PENDING",
   "authorization":true,
   "customer_id":"9e01d019-b438-40d2-89e1-52430c69dfb7",
   "re_enroll":false,
   "external_id":null,
   "bank_id":"9e01d019-b731-48bc-b111-2baa3ea56ef6",
   "bank":{
      "id":"9e01d019-b731-48bc-b111-2baa3ea56ef6",
      "name":"Maggio-Hills",
      "logo":null,
      "base64_logo":""
   },
   "customer":{
      "id":"9e01d019-b438-40d2-89e1-52430c69dfb7",
      "first_name":"Izaiah",
      "last_name":"Rogahn",
      "email":"",
      "phone":"+17478695836",
      "document_type":"CC",
      "document_number":"156762",
      "created_at":"2025-01-19T17:03:55.000000Z",
      "is_test":true
   }
}

curl https://api.onepay.la/v1/accounts \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: account-001" \
  -d '{
    "subtype": "SAVINGS",
    "authorization": true,
    "re-enrollment": false,
    "account_number": "1234567890",
    "customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
    "bank_id": "9957817c-f17e-472b-b531-e3d1490bf757"
  }'