Comercios
Crear cuentas virtuales
Crea una subcuenta virtual adicional para un comercio en un canal de pago fiat ya activado, para enrutar fondos por alias.
POST
/
v2
/
merchant
/
virtual
/
accounts
Crear cuentas virtuales
curl --request POST \
--url https://api-test.velafi.com/v2/merchant/virtual/accounts \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"merchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"alias": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/merchant/virtual/accounts"
payload = {
"merchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"alias": "<string>"
}
headers = {
"X-BH-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-BH-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({merchantId: 123, fiat: '<string>', paymentId: 123, alias: '<string>'})
};
fetch('https://api-test.velafi.com/v2/merchant/virtual/accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api-test.velafi.com/v2/merchant/virtual/accounts")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantId\": 123,\n \"fiat\": \"<string>\",\n \"paymentId\": 123,\n \"alias\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"fiat": "<string>",
"status": 123
}
}Usa este endpoint para crear cuentas virtuales adicionales en un canal de pago fiat ya activado. Cada cuenta virtual recibe sus propios datos bancarios únicos (p. ej., una CLABE o un CVU dedicado), para que puedas enrutar y conciliar fondos por alias. La cuenta en la moneda fiat correspondiente debe estar activa antes de que puedas crear cuentas virtuales. Las monedas admitidas son MXN, ARS, BRL y COP.
Todas las solicitudes deben incluir el header
X-BH-TOKEN y Content-Type: application/json. El valor de alias solo puede contener letras y números.Endpoint
POST https://api.velafi.com/v2/merchant/virtual/accounts
Parámetros de la solicitud
number
requerido
ID del comercio para el que se crea la cuenta virtual.
string
requerido
Moneda fiat de la cuenta virtual. Valores admitidos:
MXN, ARS, BRL, COP.number
requerido
ID del canal de pago que se usará. Correspondencias admitidas:
72o105: MXN63: ARS68(ACH automático) o69(Bre-B): COP90o92: BRL
string
requerido
Un alias único para esta cuenta virtual, formado solo por letras y dígitos (hasta 64 caracteres). Para COP (
68, 69), el alias debe tener de 6 a 21 letras mayúsculas o dígitos. default (en cualquier combinación de mayúsculas y minúsculas) está reservado y no se puede usar. La solicitud se rechaza si el mismo comercio ya tiene una cuenta virtual pendiente o activa con el mismo fiat, paymentId y alias.Campos de la respuesta
number
Código de respuesta tipo HTTP.
200 indica éxito.string
Mensaje de estado legible, p. ej.
SUCCESS.object
Mostrar Campos de data
Mostrar Campos de data
Ejemplo
cURL
curl -X POST https://api.velafi.com/v2/merchant/virtual/accounts \
-H "X-BH-TOKEN: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"merchantId": 151209,
"fiat": "MXN",
"paymentId": 105,
"alias": "store001"
}'
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": {
"fiat": "MXN",
"status": 1
}
}
Usa alias distintos para asignar cuentas virtuales a usuarios, tiendas o centros de costos individuales dentro de tu plataforma. El alias es permanente: crea una nueva cuenta virtual si necesitas un identificador diferente.
⌘I
Crear cuentas virtuales
curl --request POST \
--url https://api-test.velafi.com/v2/merchant/virtual/accounts \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"merchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"alias": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/merchant/virtual/accounts"
payload = {
"merchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"alias": "<string>"
}
headers = {
"X-BH-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-BH-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({merchantId: 123, fiat: '<string>', paymentId: 123, alias: '<string>'})
};
fetch('https://api-test.velafi.com/v2/merchant/virtual/accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api-test.velafi.com/v2/merchant/virtual/accounts")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantId\": 123,\n \"fiat\": \"<string>\",\n \"paymentId\": 123,\n \"alias\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"fiat": "<string>",
"status": 123
}
}