Configurar Cuenta Bancaria

Actualiza la cuenta bancaria default del tenant asociado al ACCOUNT_ID, guardando los datos operativos requeridos para dispersión/retiro: beneficiario, clabe e institucion.

Propósito

Configurar o actualizar la cuenta bancaria principal del tenant.
Este paso habilita la operación de retiros/dispersión al tener beneficiario + CLABE + institución.

Seguridad

Requiere Authorization: Bearer access_token
Scope requerido: onboarding.write
Requiere firma e integridad:
Idempotency-Key
X-Request-Id
X-Timestamp
X-Nonce
Content-Digest
X-Signature
X-Signature-Key-Id

Path parameter

ACCOUNT_ID (string, requerido): identificador del account creado en el alta (acc_...).

Body (application/json)

  "beneficiario": "CLIENTE DEMO SA DE CV",
  "clabe": "012180001118359719",
  "institucion": 40012
}

Validaciones de negocio

El ACCOUNT_ID debe existir y pertenecer al partnerId del token.
beneficiario requerido, no vacío.
clabe requerida, exactamente 18 dígitos (^\d{18}$).
institucion requerida, entero positivo.

Respuesta exitosa

  "accountId": "acc_rP3dQ7vL9mKx2wNt",
  "tenantId": "pay_01J9DEMO001",
  "beneficiario": "CLIENTE DEMO SA DE CV",
  "clabe": "012180001118359719",
  "institucion": 40012,
  "updatedAt": "2026-04-12T18:30:00.000Z"
}

💡

Errores comunes

400 Bad Request: faltan campos o formato inválido (clabe/institucion).
401 Unauthorized: token inválido, timestamp fuera de ventana, firma inválida.
403 Forbidden: scope insuficiente o account no autorizado para ese partner.
404 Not Found: ACCOUNT_ID no existe para ese partner.
409 Conflict: replay/idempotencia según middleware de seguridad.

📌

Notas para firma

Método firmado: PUT
Path firmado (según implementación actual):
/accounts/{ACCOUNT_ID}/default-bank-account
No usar el path completo /api/partner/v1/... dentro del canonical string.

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

curl --location --request PUT 'https://stp.paydaymx.com/api/partner/v1/accounts/acc_JuNE1ingW5jmzohk/default-bank-account' \ --header 'Idempotency-Key: ' \ --header 'X-Request-Id: ' \ --header 'X-Timestamp: ' \ --header 'X-Nonce: ' \ --header 'Content-Digest: ' \ --header 'X-Signature: ' \ --header 'X-Signature-Key-Id: v1' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "beneficiario": "CLIENTE DEMO SA DE CV", "clabe": "012180001118359719", "institucion": 40012 }'

{ "accountId": "acc_JuNE1ingW5jmzohk", "tenantId": "pay_01J9DEMO001", "beneficiario": "CLIENTE DEMO SA DE CV", "clabe": "012180001118359719", "institucion": 40012, "updatedAt": "2026-04-12T21:21:29.437Z" }

Solicitud

Respuestas