Crear Cuenta

Crea una cuenta de partner en el sistema: alta de Tenant + asociación/creación del usuario owner admin con contraseña temporal.

Objetivo

Provisionar un tenant nuevo.
Generar centroCosto automático de 3 dígitos.
Crear o vincular usuario owner.
Devolver datos operativos iniciales del account.

Seguridad requerida

Bearer token de partner (client_credentials).
Scope obligatorio: onboarding.write.

Headers obligatorios:
Authorization: Bearer access_token
Idempotency-Key: uuid V4
X-Request-Id: uuid V7
X-Timestamp: epoch_millis
X-Nonce: base64url_16bytes
Content-Digest: SHA-256=base64url_hash_body
X-Signature: hmac_sha256_base64url
X-Signature-Key-Id: v1

Canonical para firma

Método: POST
Path firmado (como está implementado): /accounts
Query canonical: vacío si no hay query params
Estructura:
METHOD\nPATH\nQUERY\nCONTENT_DIGEST\nTIMESTAMP\nNONCE\nIDEMPOTENCY_KEY

Request body

  "externalAccountId": "cli_000123",
  "tenantId": "pay_01J9DEMO001",
  "tenantName": "Cliente Demo SA de CV",
  "owner": {
    "email": "admin@cliente.com",
    "name": "Admin Cliente"
  },
  "metadata": {
    "segment": "retail"
  }
}

Campos requeridos

externalAccountId (string)
tenantId (string, único global)
tenantName (string)
owner.email (string)
owner.name (string)

Reglas de negocio

tenantId no puede existir previamente.
externalAccountId debe ser único por partner.
centroCosto se asigna automáticamente en formato 000-999.

Si el owner no existe, se crea con password temporal.
Si el owner ya existe, solo se vincula al tenant y no se devuelve password temporal.

Respuesta exitosa 201

  "accountId": "acc_xxx",
  "tenantId": "pay_01J9DEMO001",
  "centroCosto": "047",
  "status": "active",
  "owner": {
    "userId": "6801abcdef123456",
    "email": "admin@cliente.com",
    "temporaryPassword": "....",
    "mustResetPassword": true
  }
}

📌

Nota: temporaryPassword solo aparece cuando el usuario se crea por primera vez.

Errores comunes

400 campos requeridos faltantes o inválidos.
401 token inválido/expirado, firma inválida, timestamp fuera de ventana.
403 scope insuficiente (onboarding.write).
404 partner inactivo/no encontrado (en validación de seguridad).
409 tenantId duplicado o externalAccountId duplicado para ese partner.
503 no se pudo asignar centroCosto.

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

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

curl --location 'https://stp.paydaymx.com/api/partner/v1/accounts' \ --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-raw '{ "externalAccountId": "cli_000123", "tenantId": "pay_01J9DEMO001", "tenantName": "Cliente Demo SA de CV", "owner": { "email": "admin@clientedemo.com", "name": "Admin Cliente" }, "metadata": { "segment": "retail" } }'

{ "accountId": "acc_e92fACyl1R_DeoQE", "tenantId": "pay_01J9DEMO001", "centroCosto": "031", "status": "active", "owner": { "userId": "69db364bf1954699dc26d41f", "email": "admin@clientedemo.com", "temporaryPassword": "g3wsVRugNpqnfJg5EXhvFhBuoCDFoXOi", "mustResetPassword": true } }

Solicitud

Respuestas