Documento técnico para 🇲🇽 México

Asigna cuentas fijas a tus usuarios para realizar depósitos o pagos sin tener que estar cambiando la cuenta por cada transacción.

A continuación se dará explicación a los endpoints https necesarios para asignar, editar, eliminar y consultar las cuentas de usuario. En todos los casos será necesario enviar las credenciales de acceso proporcionadas por el equipo de soporte de ETPay en la cabeceras como se muestra a continuación:

Cabeceras

{
    "merchant_code": "mx_merchant",
    "merchant_api_token": "Hu9JYFasEt[...]bbtgFObZGA"
}

Parámetros de entrada

Parámetro Descripción
user_account_id Identificador interno de la cuenta del usuario (útil para conciliación). El valor puede ser una cadena de texto o un número de máximo 40 caracteres. Parámetro opcional.
user_phone Indica el número de teléfono del usuario. El valor tiene que ser una cadena de texto de solo números de 10 caracteres. Parámetro opcional.
user_email Indica el correo electrónico del usuario al que le llegara la confirmación del pago de máximo 40 caracteres. El valor tiene que ser una cadena de texto con formato de correo electrónico. Parámetro obligatorio.
user_name Indica el nombre completo del usuario que realizará el pago. El valor tiene que ser una cadena de texto con al menos dos palabras y cada palabra debe contener al menos dos letras de máximo 40 caracteres. Parámetro obligatorio.

Parámetros de salida

Parámetro Descripción
token Identificador de la cuenta de usuario que será necesario almacenar para poder realizar cualquier operación sobre la misma.
clabe Cuenta CLABE autogenerada por ETPay asignada al usuario, lista para poder operar.

Asignar cuenta de usuario

Lo primero que debemos hacer antes de comenzar a operar con depósitos o con el botón de pago usando una cuenta fija por usuario es asignar la misma como se muestra en el ejemplo a continuación.

POST

{{PMT_URL}}useraccount

Cuerpo

{
	  "user_account_id": "4947699c-04a6-4862-9928-316411483a57",
    "user_email": "[email protected]",
    "user_name": "Nestor Lazcano",
    "user_phone": "5516689022"
}

Respuesta

{
    "token": "zGFhr1qdgsSSKiCEmGuWnINXh",
    "user_email": "[email protected]",
    "user_name": "Nestor Lazcano",
    "user_phone": "5516689022",
    "user_account_id": "4947699c-04a6-4862-9928-316411483a57",
    "clabe": "703281004255643431"
}