Objetivo
Niveles de Servicio y alcance
Conector Generador de Referencias
Autenticación
Generar Referencia ClubPago
Integrar Referencia en Formato de Pago
Generación de Formato de Pago
Complementos de Funcionalidad
Este documento describe como desarrollar un conector de tu plataforma o aplicación administrativo con La Plataforma Tecnológica de CLUBPAGO para que puedas utilizar nuestras HERRAMIENTAS del CONECTOR: SERVICIO DE GENERADOR DE REFERENCIAS.
CLUBPAGO ofrece recibir tus pagos:
1.- En Cadenas en todo México que forman parte de su Red de Distribución.
2.- Y por Transferencias Interbancarias SPEI.
3.- Pagos con Tarjeta de Crédito/Débito.
1.- PARA RECIBIR PAGOS DE TUS CLIENTES POR CLUBPAGO EN CADENAS
Se debe crear una Referencia CLUBPAGO que permita identificar plenamente el pago y la cual deberá ir representada en tu formato de pago o recibo en Código de Barras. Ya que gracias a esto, el punto de venta que recibe el pago puede escanearla de manera eficiente y rápida.
2.- PARA RECIBIR PAGOS DE TUS CLIENTES POR SPEI (Sistema de Pagos Electrónicos Interbancarios)
CLUBPAGO designará una CLABE (Clave Bancaria Estandarizada) única para el pago de tu cliente por SPEI y esto permitirá identificación plena a quien corresponde el pago.
Esta CLABE es entregada por CLUBPAGO a tu Empresa/Emisor si se solicita en cualquiera de los 3 métodos que incluye este SERVICIO DE GENERADOR DE REFERENCIAS para que la almacene en su base de datos ligada a su cliente o pago.
Cuando La Plataforma Tecnológica de CLUBPAGO, reciba un pago por SPEI se enviará a tu Empresa/Emisor la información del pago con identificación por Referencia CLUBPAGO, y dado que ya tienes relacionada con un cliente o pago, podrás hacer su acreditación.
3.- PARA RECIBIR PAGOS CON TARJETA CRÉDITO/DÉBITO
CLUBPAGO ofrece recibir pagos con tarjeta de crédito para sus clientes. Cualquiera de los 3 Métodos que incluye este SERVICIO DE GENERADOR DE REFERENCIAS permitirá solicitar el link de cobro con tarjeta para el pago de tu cliente en específico, de acuerdo a los datos enviados en el método: Cuenta Cliente, Monto, Descripción, correo, fecha expiración del pago.
Este link de cobro que entrega el GENERADOR DE REFERENCIAS es único para ese cliente y ya vienen definidos los datos de Referencia Cliente, Monto y Descripción, de esta manera el cliente solo documenta sus datos de tarjeta. Solo debes poner botón de acceso o enviar el link a tu cliente para que realice su pago con tarjeta.
El link de cobro tendrá vigencia hasta la fecha de expiración que enviaste al solicitarlo. Si no documentaste fecha, el link estará vigente por 60 días o hasta que se utilice para realizar un pago exitoso.
a).-Opciones de Pagos Automáticos con Tarjeta:
a.Para utilizar Pagos Automáticos deberás solicitar esta opción para pagos con Tarjeta a CLUBPAGO, si no tienes esta opción configurada en tus datos de Emisor de CLUBAPAGO no podrás utilizarla. Solo para Tarjetas de México.
b.Pagos Automáticos o Pagos Domiciliarios: Es cuando su cliente AUTORIZA que el Emisor le realice un número de cargos automáticos por un periodo determinado.
I.Funciona para tarjetas de crédito y débito.
c.Como funciona Pagos Automáticos: Deberás obtener autorización a tu cliente para realizar cargos automáticos y solicitar con cualquiera de los métodos de esteAPI pago con Tarjeta incluyendo parámetros para Pago Automático, en respuesta a la solicitud nuestro API entrega un link de pago con tarjeta, para permitiracceder a ese link tu aplicación o plataforma deberá obtener la autorización de efectuar los cargos automáticos (incluye link Términos y condiciones CLUBPAGO) yuna vez que tu cliente acepte, deberás dar acceso al link de pago con tarjeta entregado por el API. El link mostrará una ventana solicitando los siguientes datos:Número de tarjeta, vencimiento, CVV, su Nombre, correo electrónico y celular.
I.Tu cliente deberá documentar la información correcta de su tarjeta y efectuar el proceso 3D Secure donde le podrán mandar un proceso de autenticación. Tu cliente al completar este proceso recibirá pantalla informando si su pago fue exitoso o no, así como un correo electrónico.
II.Si el cliente tuvo problemas y no pudo completar su proceso, con el mismo link podrá volver a intentar pagar ya capturando sus datos como los tiene su banco y tener el celular a la mano para pasar el proceso de seguridad 3D Secure.
III.Al efectuar exitosamente este primer pago y como se solicito el link con cargos automáticos, la plataforma CLUBPAGO recibe un token, el cual utilizara para efectuar el número de cargos automáticos en el periodo de tiempo solicitado por el Emisor en cualquier método de este API.
IV.La plataforma CLUBPAGO efectuará de manera automática el número de cargos automáticos solicitados. La aplicación del Emisor ya no tendrá que efectuar nada en cada pago automático posterior solo es en el pago inicial.
V.Este API consta de un método para solicitar que el proceso de pagos automáticos sea cancelado en cualquier momento.
d.Ustedes serán responsables de solicitar a su cliente su AUTORIZACIÓN para que se le haga N cargos automáticos a su tarjeta cada N días cuando solicite un PaAutomático con pago con Tarjeta en este API.
I.Agregar check box con la siguiente leyenda a desplegar a tu cliente para que este la autorice los cargos automáticos al efectuar el primer cargo:
1.Leyenda con check box: Autorizo expresamente a “<Nombre del Emisor o cliente del Emisor>”, para que realice el cobro recurrente a mi tarjeta de crédito o débito por <Número> pagos cada <Número> días por el concepto de <Concepto de pago> que me presta y sus correspondientes consumos adicionales (según sea el caso). La vigencia de los cargos será acorde al número de pagos mencionados anteriormente o mientras me continue proveyendo el servicio o bien hasta que yo determine lo contrario.
2.Documentar su información que aparece entre <> acorde a sus necesidades.
e.El pago Automático se puede solicitar para Tarjetas de Crédito y Débitof.
f.Al solicitar un pago Automático se define:
I.Número de cargos automáticos a realizar: Si se trata de un pago indefinido documentar 99.
II.Frecuencia de pago: Cada cuantos días se hará el cargo automático, es decir puede ser como ejemplo: 7 días, 15 días , 30 días u otro
III.Dia de pago: Se determina en base al día que hizo el pago inicial exitoso el cliente y activo la tarjeta para pagos automáticos. El día de pago se determina por el número de días que se definen en la frecuencia de pago y allí la Plataforma hace el plan de el numero de pagos solicitados y la fecha a realizar el cargo.
g.Al efectuar la Plataforma CLUBPAGO los pagos automáticos, se podrá presentar el caso, que sea rechazado, ya sea por causa por falta de saldo, o por que sucliente desactivo provisionalmente o cancelo la tarjeta . Es por eso que La Plataforma CLUBPAGO efectuará 3 intentos de
hacer el cargo con diferencia de 48 horas y así permitir a tu cliente resolver problemas de saldo.
h.Si el pago automático fallo la Plataforma CLUBPAGO te envía correo avisando para que Referencia ya se cancelo el pago automático por que no se pudo hacer el cargo automático.
I.Solicitar a tu cliente que te avise si cancelo su tarjeta, y si eso pasa solicitar a la Plataforma CLUBPAGO la cancelación de pago automático e iniciar un nuevo proceso de pagos automáticos con la nueva tarjeta.
j.Para cancelar pagos automáticos en cualquier momento, utiliza el método de cancelación de este API
b).-Opciones de Meses sin Intereses (MSI) para Tarjetas de Crédito
a. Para utilizar MSI deberás solicitar esta opción para pagos con Tarjeta a CLUBPAGO, si no tienes esta opción configurada en tus datos de Emisor de CLUBAPAGO no podrás utilizarla.
b. Durante el año podrás solicitar tener esta opción activada y el también podrá definir que periodos pone disponible para su cliente. Solicita a soporte CLUBPAGO para que active y desactive meses sin intereses y que periodos pones disponibles para tus clientes
c. Las opciones de MSI son : 3,6,9 y 12 meses. Aunque cada periodo requiere un monto mínimo y también tiene una comisión diferente.
I.3 meses: $300
II.6 meses: $600
III.9 meses: $900
IV.12 meses: $1,200
d. Como funciona MSI: Al solicitar link de pago con tarjeta, deberás solicitar en el método si es con opción de MSI y también deberás enviar que periodos pones disponible a tu cliente, para que este seleccione al momento de pagar el que mejor le conviene a sus necesidades.
e. Tu cliente al entrar al link de pago con tarjeta donde tu solicitaste la opción de meses sin intereses, deberá teclear su número de tarjeta y si es de crédito le aparecerá la opción para que seleccione entre los periodos disponibles que documentaste.
f. Aunque tengas activada la opción de MSI en tu Emisor CLUBPAGO , podrás solicitar link de pagos con tarjeta sin otorgar esta opción.
g. Tu cliente al completar con éxito su proceso de pago con tarjeta, documentando sus datos y haciendo el proceso de autenticación que se le solicite. Sera su banco que haga los cargos cada mes acorde a los periodos solicitados.
h. Tu recibirás en tu reembolso de estas operaciones el monto total menos su comisión correspondiente acorde al periodo seleccionado de tu cliente.
NIVELES DE SERVICIO
| Disponibilidad de servicio Plataforma CLUBPAGO |
99% |
| Tiempo de respuesta máxima de conector CLUBPAGO |
5 segundos |
Alcance
Al desarrollar este conector con GENERADOR DE REFERENCIAS con CLUBPAGO te permitirá, reducir tu tiempo y costo de tu desarrollo para implementar el servicio de recibir tus pagos por CLUBPAGO. Te damos 3 opciones, las cuales tú decides cual es la que te conviene. TE AYUDAMOS a que tu implementación de recibir pagos en EFECTIVO por CLUBPAGO sea fácil, rápido, simple.
Definiciones y abreviaciones utilizadas
| Abreviación | Descripción |
| JSON | (acrónimo de JavaScript Object Notation, «notación de objeto de JavaScript») es un formato de texto sencillo para el intercambio de datos |
| Mensajería | Modelo de comunicación, Mensaje es la información dirigida de un emisor a un receptor. Donde ambos conocen la estructura y los conceptos de la información |
| PDV | Punto de Venta |
| Timeout | El tiempo estipulado de espera máxima para la respuesta entre emisor y receptor |
| EMISOR | Es el proveedor de servicio que requiere el pago |
| Cliente | Es el cliente final o usuario del servicio del Emisor. Es el que acude al PDV y realiza el pago |
| Referencia | Identificador de pago que presenta el Cliente al realizar su pago |
| URL | Uniform Resource Locator, es la dirección específica que se asigna a cada uno de los recursos disponibles en la red con la finalidad de que estos puedan ser localizados o identificados. |
| HTTPS | Protocolo de conectividad seguro utilizado para la Mensajería |
CONECTOR DE SERVICIO DE GENERADOR DE REFERENCIAS DE CLUBPAGO
Este Servicio te ayudará a reducir tu inversión de desarrollo tecnológico al contar con acceso a Herramientas que facilitaran emitir tus Referencias en código de barras e inclusive emitir el formato de pago y así acortar el tiempo de arrancar TU PROYECTO de recibir pagos en por CLUBPAGO
Además si deseas recibir pagos por SPEI, con esta herramienta podrá obtener una CLABE
que es única para tu cliente o pago. Y también generar link para cobro con tarjeta
El GENERADOR DE REFERENCIAS te ofrece 3 métodos/endpoints:
1.- GENERADOR DE REFERENCIA: Te genera tu referencia acorde a las especificaciones definidas para tu empresa
2.- GENERADOR CODIGO DE BARRAS: Te genera tu referencia en texto y código de Barras
3.- GENERADOR FORMATO DE PAGO: Te emite tu formato de pago completo que contiene datos cliente, referencia en texto y código de barras, cadenas donde poder pagar e instrucciones de como efectuar el pago.
NOTA: En cualquiera de los 3 métodos, se podrá solicitar la CLABE única que es la identificación de tu cliente o pago, si paga por Transferencia Interbancaria. Y también el link de cobro con tarjeta para el cliente especifico de acuerdo a los datos utilizados.
DEFINICIÓN DE TÚ REFERENCIA
Lo primero que se tienes que hacer es definir con CLUBPAGO la estructura de tu Referencia, dado que los datos a incluir en tu Referencia estarán en función del requerimiento de tu pago y el tipo de conexión que utilices con CLUBPAGO.
Se pueden tener 2 tipos de conexión con CLUBPAGO para ser notificado de tus pagos:
1) BATCH: En este caso no hay conexión directa con CLUBPAGO, aquí la Referencia nos ayudará a recibir pagos válidos. Ya que, si requieres que el pago de tu cliente sea de un monto exacto, lo conveniente es incluir el monto solicitado en la Referencia, así de esta forma cuando se esté haciendo el pago solo se aceptará el pago por dicho monto, así mismo si el pago tiene una fecha de vencimiento y después de esa fecha ya no se debe aceptar el pago, será conveniente agregar fecha límite de pago en la estructura de la referencia.
Para un Emisor con conexión BATCH si puede ofrecer a sus clientes recibir pagos por SPEI. Si tiene un monto exacto y fecha de vencimiento debe incluirlo en la estructura de su referencia CLUBPAGO, para que la Plataforma CLUBPAGO lo verifica y controla al recibir el pago por transferencia bancaria. Ahora si acepta pagos parciales y vencidos NO IMPORTA QUE NO QUE NO LOS INCLUYA EN LA REFERENCIA no tendrá problemas ya que acreditará el pago parcial y/o recibido.
2) CONEXIÓN EN LÍNEA: Al tener una conexión permanente entre plataforma tecnológica de tu Empresa/Emisor y la de CLUBPAGO, facilitará que cuando tu cliente está realizando su pago, tu plataforma podrá validar monto y vigencia en tiempo real. Así de esta manera tu Referencia debe ser más sencilla y con incluir el número de identificación único que asignes a tu cliente será suficiente. (Para el desarrollo de conexión en línea para recibir pagos, solicita la Guía de Integración y Documentación Técnica Emisores)
Para un Emisor con conexión EN LÍNEA al ofrecer a sus clientes recibir pagos por SPEI, si su conexión rechaza al pago por monto incorrecto o por pago vencido, la plataforma de CLUBPAGO rechazara el pago de su cliente, registrando transferencia no realizada.
Pago con tarjeta se genera personalizado con el monto, referencia y demás datos documentados al solicitar la generación del link de pago con tarjeta. Y solo deberá poner disponible este link a su cliente para que realice su pago.
Además en cualquiera de las conexiones se podrá recibir pagos con tarjeta utilizando el web de pagos con tarjeta de crédito o débito de CLUBPAGO, si se genera un link de pago con tarjeta utilizando cualquiera los métodos del GENERADOR DE REFERENCIAS o sitio administrativo CLUBPAGO https://sitio.clubpago.site/ cuando el cliente entre a la web de pagos con tarjeta de CLUBPAGO https://pagoscontarjeta.clubpago.site/ solicita el pago por tarjeta ya tiene los datos pre-documentados y solo documenta sus datos de tarjeta.
Si no se genera link de pago con tarjeta, el cliente captura su referencia y el monto a pagar.
En términos generales la estructura de la Referencia CLUBPAGO puede incluir lo siguiente:
I. Identificador de tu empresa para CLUBPAGO (6 dígitos). Esto es asignado por la
Plataforma CLUBPAGO al momento en que es dado de alta
II. Número de cliente o identificación de operación
III. Monto de la operación (opcional)
IV. Fecha límite para aceptar pago (opcional)
V. Digito Verificador (Este permitirá evitar que si se captura manualmente se comentan errores)
La longitud de la Referencia CLUBPAGO, puede ser hasta de 29 dígitos. Los primeros 6
dígitos definen al EMISOR y la identificación de su cliente o pago puede incluir su
número de identificación y de manera opcional puede contener monto y fecha de
vencimiento. Y el último dígito es el CODIGO VERIFICADOR.
El Emisor define las características de su Referencia cuando es creada en CLUBPAGO, de tal manera que la Plataforma CLUBPAGO ya conoce la información que forma tu referencia y su longitud.
| Dato | Descripción | Formato | Columna |
| PREFIJO | Número fijo | Numérico (777) | 1 al 3 |
| SUB-ID | Número Identificador de “LA EMPRESA” proporcionado por CLUBPAGO |
Numérico (XXX) | 4 al 6 |
| IDENTIFICA | Número de identificador del cliente o pago , monto y fecha de vencimiento (solo si requiere y detallar longitud y orden | Numérico, Se conforma acorde a id del cliente, monto y fecha vigencia (estas 2 últimas opcionales). Si solo incluye id cliente rellenar con 0 a la izquierda para cumplir la longitud definida |
7 al X |
| DV | Digito Verificador | Numérico (1) | X |
a. Datos Dinámicos. CLUBPAGO permite al Emisor conformar su Referencia CLUBPAGO de acuerdo a sus necesidades; a continuación, se describen cada uno de los datos que podrá incluir o no, en la formación de su código.
b. Identificador: Debe ser un dato numérico único que identifica plenamente a su cliente.
I. El Emisor puede decidir el número de dígitos para identificar a su cliente o pago, la longitud es variable.
II. Monto: Este dato si se incluye permitirá que La Plataforma Tecnológica de CLUBPAGO obligue que, para completar exitosamente el proceso de pago, el monto pagado debe ser igual a este valor contenido en su Referencia. Esta opción la deberán utilizar si el Emisor requiere recibir un monto exacto, como pudiera ser el caso de compras por internet donde al contener en el código de barras el monto exacto a pagar; hará que el cliente realice un pago con la cantidad exacta requerida y evitar problemas con su cliente.
Desde luego el Monto debe ser numérico con el número de decimales que así convenga al Emisor. Se sugiere 8 dígitos con 2 decimales.
Ahora si su necesidad no requiere restringir a un monto especifico a pagar, simplemente no incluirlo en el código.
III. Fecha vigencia: De igual forma si el pago del Emisor tiene una fecha límite. Y una vez se rebase esta fecha el pago no puede ser aceptado, es conveniente incluirlo en la Referencia. Si, aunque se tenga una fecha límite de pago, se pueden aceptar pagos vencidos, la recomendación seria no incluir fecha en la Referencia.
IV. Para el caso en que el Emisor usa el API de CLUBPAGO , no será necesario incluir monto y/o fecha vigencia, ya que al recibir el pago V. el conector del Emisor se le pide validar la referencia antes de recibir pago.
c. Dígito Verificador (DV). El DV es de un solo 1 digito y busca ser un código de control que evite capturas incorrectas cuando por cualquier razón no se utiliza un lector de código de barras si no que se teclea. Gracias a este DV se pueden detectar errores del cajero en el tecleo. La generación del dígito verificador deberá ser en Mod10. *La generación del dígito verificador deberá ser en Mod10 Aquí su algoritmo de generación.
d. Ejemplos:
1. “LA EMPRESA” requiere una referencia para identificar el cliente y/o pago. Su id de identificación de su cliente o orden de pago es de 6 dígitos
| Campo | Descripción | Formato | Columna | Tipo |
| PREFIJO | Número fijo para identificar al emisor. | ALFANUMÉRICO (777) | 1 al 3 | Obligatorio |
| SUB-ID | Número Identificador proporcionado por CLUBPAGO | ALFANUMÉRICO (101) | 4 al 6 | Obligatorio |
| IDENTIFICADOR | Número de identificación del cliente. | Numérico 6 dígitos. | 7 al 12 | Obligatorio |
| DV | Digito Verificado | Numérico 1 digito | 13 | Obligatorio |
El SUB-ID o identificador de EMPRESA = 101
Referencia: no. de cliente = 257631 Y para cubrir la longitud de 6 agregar ceros
izquierda si es no.cliente tiene menos de 6 dígitos. En este caso como el número es de
6 dígitos, no es necesario agregar ceros
Se obtiene el digito verificador acorde a Mod10 algoritmo:
https://es.wikipedia.org/wiki/Algoritmo_de_Luhn
CÓDIGO DE BARRAS SERIA : 7771012576319
2. “LA EMPRESA” requiere una referencia para identificar el cliente y/o pago y el monto.
De esta manera al tener monto en el código cuando se reciba el pago, la Plataforma Tecnológica definirá ese monto como el valor de pago y solo se podrá hacer la aceptación de pago con ese monto.
| Campo | Descripción | Formato | Columna | Tipo |
| PREFIJO | Número fijo para identificar al emisor. | ALFANUMÉRICO (777) | 1 al 3 | Obligatorio |
| SUB-ID | Número Identificador proporcionado por CLUBPAGO | ALFANUMÉRICO (101) | 4 al 6 | Obligatorio |
| IDENTIFICADOR | Número de identificación del cliente. | Numérico 6 dígitos. | 7 al 12 | Obligatorio |
| MONTO | Monto Fijo | Numérico 7 dígitos. (2 decimales) |
12 al 18 | Opcional |
| DV | Digito Verificado | Numérico 1 digito | 19 | Obligatorio |
El SUB-ID o identificador de EMPRESA = 101
Referencia: no. de cliente = 051322 Y para cubrir la longitud de 6 agregar ceros
izquierda
Monto =1500.00
Se obtiene el digito verificador acorde a Mod10 algoritmo:https://es.wikipedia.org/wiki/Algoritmo_de_Luhn
CÓDIGO DE BARRAS SERIA : 77710105132201500006
AUTENTICACIÓN PARA EL EMISOR
Para utilizar este conector GENERADOR DE REFERNCIAS, lo primero es hacer un proceso de Autenticación.
Se requiere conectarte por la siguiente URL AMBIENTE DE PRUEBAS:
https://qa.clubpago.site/auth/api/auth
Utilizar el método Http.Post
Recibe un JSON con la siguiente estructura:
| Nombre del Campo | Tipo del Valor | Descripción |
| user | Alfanumérico | Usuario |
| pswd | Alfanumérico | Contraseña |
Ejemplo de Solicitud :
var options = new RestClientOptions("")
{
MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("https://qa.clubpago.site/auth/api/auth", Method.Post);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@" ""User"": ""user_qa"",
" + "\n" +
@" ""Pswd"": ""cd#jdkis$.6""
" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://qa.clubpago.site/auth/api/auth")
.header("Content-Type", "application/json")
.body("{\r\n \"User\": \"user_qa\",\r\n \"Pswd\": \"cd#jdkis$.6\"\r\n}")
.asString();
<?php$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://qa.clubpago.site/auth/api/auth',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"User": "user_qa",
"Pswd": "cd#jdkis$.6"
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json'
),
));$response = curl_exec($curl);
curl_close($curl);
echo $response;
curl --location 'https://qa.clubpago.site/auth/api/auth' \
--header 'Content-Type: application/json' \
--data '{
"User": "user_qa",
"Pswd": "cd#jdkis$.6"
}'La autenticación de CLUBPAGO entregará un TOKEN que funcionará como identificador Único para el EMISOR. Este TOKEN es de longitud variable y se forma de letras y números. Entrega un JSON con la siguiente estructura:
| Nombre del Campo | Tipo del Valor | Descripción |
| Message | Alfanumérico | Mensaje (Exito, Error, etc) |
| Token | Alfanumérico | Serie de caracteres que contiene la información para la autenticación. |
| Expiration | Fecha | Fecha de vigencia del Token |
Ejemplo de Respuesta Exitosa :
{
“Message”: “Exito”,
“Token”: “eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9… “,
“Expiration”: “2020-05-20T00:29:34.2612771-05:00”
}
Ejemplo de Respuesta Faliida:
{
“Message”: “Datos Incorrectos”,
“Token”: “”,
“Expiration”: “0001-01-01T00:00:00”
}
GENERACIÓN DE REFERENCIAS DE CLUBPAGO
El Emisor define qué tipos de pagos CLUBPAGO va utilizar.
1.- Pagos en Efectivo en Cadenas
2.- Pagos por SPEI
3.- Pago con tarjeta de crédito/débito
Puede seleccionar los 3 tipos, dos o solo uno
Ofrecemos cubrir 3 diferentes necesidades de Nuestros Emisores de pago con el uso de 3 Métodos o endpoints que se incluye en EL GENERADOR DE REFERENCIAS:
1) Solo requieres generar la REFERENCIA CLUBPAGO para cada cliente u operación, ya que cuenta con capacidades tecnológicas para ya teniendo el número de REFERENCIA válida, se podrá agregar en tu formato de pago, CLABE única para transferencia bancaria y link de pago con tarjeta.
Para esto, debes hacer lo siguiente:
Generar una Referencia CLUBPAGO para tu cliente o tu operación de compra o servicio.
También podrás solicitar una CLABE (Clave Bancaria estandarizada) única para tu cliente o tu operación. (Debe tener el Emisor configurado pagos por SPEI)
Y solicitar link de cobro con tarjeta para una referencia CLUBPAGO con o sin opciones.
USAR EL MÉTODO de GENERADOR DE REFERENCIAS: OBTENER UNA REFERENCIA, donde enviaras los datos que te solicita este método y este TE ENTREGARA TU REFERENCIA CLUBPAGO, acorde a las características definidas de la Referencia cuando tu empresa/Emisor se dio de alta en la Plataforma de CLUBPAGO. La respuesta del método entrega Referencia en formato String (cadena de caracteres).
También podrás solicitar una CLABE única y link de pago con tarjeta con las opciones de pagos automáticos y MSI (meses sin intereses).
Se envía el método para OBTENER UNA REFERENCIA:
https://qa.clubpago.site/referencegenerator/svc/generator/reference
Se debe incluir el Token en el Header Authorization de la siguiente manera:
| Key | Value | Descripción |
| Authorization | {{TOKEN}} | Método de autenticación de usuarios |
Utilizar el método Http.Post
Recibe un JSON con la siguiente estructura:
| Nombre del Campo | Tipo del Valor | Descripción |
| Description | Alfanumérico | Descripción de la Referencia |
| Amount | Numérico incluye decimales | Monto a pagar |
| Account | Numérico | Cuenta o Cliente |
| CustomerEmail | Alfanumérico OPCIONAL | Correo del Cliente |
| CustomerName | Alfanumérico OPCIONAL | Nombre del cliente |
| ExpirationDate | Alfanumérico OPCIONAL | Fecha de Expiración |
| RequestClabe | Falso/Verdadero | Solicitar CLABE |
| RequestPayTD | Falso/Verdadero | Solicitar URL para pago con tarjeta de crédito/débito |
ExpirationDate tiene la condición que si las especificaciones de la referencia lo incluye, previamente acordadas en contrato, es obligatoria cuando no es necesaria se manda un “null”
Amount si se quiere representar un número con decimales 152.30 este será: 15230, los últimos 2 dígitos representan los decimales
Responde un JSON con la siguiente estructura:
| Nombre del Campo | Tipo del Valor | Descripción |
| Reference | Numérico | Referencia generada |
| BarCode | Alfanumérico (URL) | Código de barras generado |
| PayFormat | Alfanumérico (URL) | Formato de pago generado |
| Message | Alfanumérico | Mensaje del resultado de la solicitud |
| Error | Alfanumérico | Mensaje de error de la solicitud |
| Folio | Numérico | Identificador de la operación |
| Date | Fecha | Fecha de la solicitud |
| Clabe | Numérico | CLABE |
| PaymentTD | Alfanumérico (URL) | Liga para pago con tarjeta de crédito/débito |
Ejemplo de Solicitud :
var options = new RestClientOptions("") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("https://qa.clubpago.site/referencegenerator/svc/generator/reference", Method.Post); request.AddHeader("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM"); request.AddHeader("Content-Type", "application/json"); var body = @"{ " + "\n" + @"""Description"": ""Test"", " + "\n" + @"""Amount"": 10000, " + "\n" + @"""Account"": ""1234561"", " + "\n" + @"""CustomerEmail"": ""qa_it@clubpago.mx"", " + "\n" + @"""CustomerName"": ""Ricardo Carranza"", " + "\n" + @"""ExpirationDate"": ""2024-12-30"", " + "\n" + @"""RequestClabe"": 1, " + "\n" + @"""RequestPayTD"": 0 " + "\n" +
Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.post("https://qa.clubpago.site/referencegenerator/svc/generator/reference") .header("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM") .header("Content-Type", "application/json") .body("{\r\n\"Description\": \"Test\",\r\n\"Amount\": 10000,\r\n\"Account\": \"1234561\",\r\n\"CustomerEmail\": \"qa_it@clubpago.mx\",\r\n\"CustomerName\": \"Ricardo Carranza\",\r\n\"ExpirationDate\": \"2024-12-30\",\r\n\"RequestClabe\": 1,\r\n\"RequestPayTD\": 0\r\n}") .asString();
<?php$curl = curl_init();curl_setopt_array($curl, array( CURLOPT_URL => 'https://qa.clubpago.site/referencegenerator/svc/generator/reference', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS =>'{ "Description": "Test", "Amount": 10000, "Account": "1234561", "CustomerEmail": "qa_it@clubpago.mx", "CustomerName": "Ricardo Carranza", "ExpirationDate": "2024-12-30", "RequestClabe": 1, "RequestPayTD": 0 }', CURLOPT_HTTPHEADER => array( 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM', 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response;
curl --location 'https://qa.clubpago.site/referencegenerator/svc/generator/reference' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM' \
--header 'Content-Type: application/json' \
--data-raw '{
"Description": "Test",
"Amount": 10000,
"Account": "1234561",
"CustomerEmail": "qa_it@clubpago.mx",
"CustomerName": "Ricardo Carranza",
"ExpirationDate": "2024-12-30",
"RequestClabe": 1,
"RequestPayTD": 0
}'
Ejemplo de Respuesta Exitosa :
{
“Reference”: “777370000012345613”,
“BarCode”: null,
“PayFormat”: null,
“Message”: “Exitosa”,
“Error”: null,
“Folio”: “450724”,
“Date”: “2026-03-02T17:23:05.2259131-06:00”,
“Clabe”: “646180227790156622”,
“PaymentTD”: “”,
“Amount”: “100.000000”,
}
Ejemplo de Respuesta Fallida :
{
“Reference”: “”,
“BarCode”: null,
“PayFormat”: null,
“Message”: “Error en Referencia”,
“Error”: “El monto es menor al monto mínimo configurado | Monto Mínimo: 20.000000”,
“Folio”: “450738”,
“Date”: “2026-03-03T09:50:11.4411612-06:00”,
“Clabe”: null,
“PaymentTD”: “”,
“Amount”: “1.000000”,
}
INTEGRAR REFERENCIA EN FORMATO DE PAGO
Si ya cuentas con tu recibo o formato de pago y requieres generar una REFERENCIA CLUBPAGO para cada cliente u operación incluyendo la imagen en código de barras, y así lo podrás agregar a tu formato o recibo.
Para esto, debes hacer lo siguiente:
Generar una Referencia e imagen de Código de Barras.
También podrás solicitar una CLABE (Clave Bancaria estandarizada) única para tu cliente o tu operación. (Debe tener el Emisor configurado pagos por SPEI)
Y solicitar link de cobro con tarjeta para una referencia CLUBPAGO con o sin opciones.
Con el método: OBTENER CODIGO DE BARRAS. Enviaras los datos que te solicita este método y este TE ENTREGARA TU REFERENCIA CLUBPAGO y su representación en CODIGO DE BARRAS, acorde a las características definidas de la Referencia cuando tu empresa se dio de alta en la Plataforma de CLUBPAGO.
También podrás solicitar una CLABE única y link de cobro con Tarjeta
https://qa.clubpago.site/referencegenerator/svc/generator/barcode
Se debe incluir el Token en el Header Authorization de la siguiente manera:
| Key | Value | Descripción |
| Authorization | {{TOKEN}} | Método de autenticación de usuarios |
Utilizar el método Http.Post
Recibe un JSON con la siguiente estructura:
| Nombre del Campo | Tipo del Valor | Descripción |
| Description | Alfanumérico | Descripción de la Referencia |
| Amount | Numérico incluye decimales | Monto a pagar |
| Account | Numérico | Cuenta o Cliente |
| CustomerEmail | Alfanumérico OPCIONAL | Correo del Cliente |
| CustomerName | Alfanumérico OPCIONAL | Nombre del cliente |
| ExpirationDate | Alfanumérico OPCIONAL | Fecha de Expiración |
| RequestClabe | Falso/Verdadero | Solicitar CLABE |
| RequestPayTD | Falso/Verdadero | Solicitar URL para pago con tarjeta de crédito/débito |
ExpirationDate tiene la condición que si las especificaciones de la referencia lo incluye, previamente acordadas en contrato, es obligatoria cuando no es necesaria se manda un “null”
Amount si se quiere representar un número con decimales 152.30 este será: 15230, los últimos 2 dígitos representan los decimales
Responde un JSON con la siguiente estructura:
| Nombre del Campo | Tipo del Valor | Descripción |
| Reference | Numérico | Referencia generada |
| BarCode | Alfanumérico (URL) | Código de barras generado |
| PayFormat | Alfanumérico (URL) | Formato de pago generado |
| Message | Alfanumérico | Mensaje del resultado de la solicitud |
| Error | Alfanumérico | Mensaje de error de la solicitud |
| Folio | Numérico | Identificador de la operación |
| Date | Fecha | Fecha de la solicitud |
| Clabe | Numérico | CLABE |
| PaymentTD | Alfanumérico (URL) | Liga para pago con tarjeta de crédito/débito |
Ejemplo de Solicitud :
var options = new RestClientOptions("") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("https://qa.clubpago.site/referencegenerator/svc/generator/reference", Method.Post); request.AddHeader("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM"); request.AddHeader("Content-Type", "application/json"); var body = @"{ " + "\n" + @"""Description"": ""Test"", " + "\n" + @"""Amount"": 10000, " + "\n" + @"""Account"": ""12345"", " + "\n" + @"""CustomerEmail"": ""qa_it@clubpago.mx"", " + "\n" + @"""CustomerName"": ""Ricardo Carranza"", " + "\n" + @"""ExpirationDate"": ""2024-12-30"", " + "\n" + @"""RequestClabe"": 1, " + "\n" + @"""RequestPayTD"": 1 " + "\n" +
Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.post("https://qa.clubpago.site/referencegenerator/svc/generator/reference") .header("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM") .header("Content-Type", "application/json") .body("{\r\n\"Description\": \"Test\",\r\n\"Amount\": 10000,\r\n\"Account\": \"12345\",\r\n\"CustomerEmail\": \"qa_it@clubpago.mx\",\r\n\"CustomerName\": \"Ricardo Carranza\",\r\n\"ExpirationDate\": \"2024-12-30\",\r\n\"RequestClabe\": 1,\r\n\"RequestPayTD\": 1\r\n}") .asString();
<?php$curl = curl_init();curl_setopt_array($curl, array( CURLOPT_URL => 'https://qa.clubpago.site/referencegenerator/svc/generator/reference', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS =>'{ "Description": "Test", "Amount": 10000, "Account": "12345", "CustomerEmail": "qa_it@clubpago.mx", "CustomerName": "Ricardo Carranza", "ExpirationDate": "2024-12-30", "RequestClabe": 1, "RequestPayTD": 1 }', CURLOPT_HTTPHEADER => array( 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM', 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response;
curl --location 'https://qa.clubpago.site/referencegenerator/svc/generator/reference' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM' \
--header 'Content-Type: application/json' \
--data-raw '{
"Description": "Test",
"Amount": 10000,
"Account": "12345",
"CustomerEmail": "qa_it@clubpago.mx",
"CustomerName": "Ricardo Carranza",
"ExpirationDate": "2024-12-30",
"RequestClabe": 1,
"RequestPayTD": 1
}'
Ejemplo de Respuesta Exitosa :
{
“Reference”: “777370000000123457”,
“BarCode”: “https://qa.clubpago.site/referencegenerator/Barcodes/12345_450739.png”,
“PayFormat”: null,
“Message”: “Exitosa”,
“Error”: null,
“Folio”: “450739”,
“Date”: “2026-03-03T10:27:51.0732469-06:00”,
“Clabe”: “646180227790156651”,
“PaymentTD”: “https://qa.clubpago.site/referencegenerator/450739”,
“Amount”: “100.000000”,
}
RESULTADO REFERENCIA CLUBPAGO: 777370000000123457 y no se solicitó CLABE y no solicito link para cobro con tarjeta.
Ejemplo de Respuesta Fallida :
{
“Reference”: “”,
“BarCode”: null,
“PayFormat”: null,
“Message”: “Error en Referencia”,
“Error”: “El monto es menor al monto mínimo configurado | Monto Mínimo: 20.000000”,
“Folio”: “450744”,
“Date”: “2026-03-03T10:46:31.8239289-06:00”,
“Clabe”: null,
“PaymentTD”: “”,
“Amount”: “1.000000”,
}
GENERACIÓN DE FORMATO DE PAGO
Si ya cuentas con tu recibo o formato de pago y requieres generar una REFERENCIA CLUBPAGO para cada cliente u operación incluyendo la imagen en código de barras, y así lo podrás agregar a tu formato o recibo.
Utiliza nuestra opción completa, el MÉTODO de GENERADOR DE REFERENCIAS: OBTENER FORMATO DE PAGO. CON ESTA OPCION te reducimos y simplificamos el desarrollo. Ya que te entregamos una URL donde tu cliente podrá acceder al formato de pago en PDF y deberá imprimir o descargar su formato fácilmente.
También podrás solicitar una CLABE (Clave Bancaria estandarizada) única para tu cliente o tu operación. (Debe tener el Emisor configurado pagos por SPEI)
Y solicitar link de cobro con tarjeta para una referencia CLUBPAGO con o sin opciones.
Ejemplo: La Referencia que define el emisor de pagos es incluir solo su identificador de cliente, ya que el monto viene es su formato de pago y además acepta pagos parciales y vencidos.
Se envía el método OBTENER FORMATO DE PAGO con:
https://qa.clubpago.site/referencegenerator/svc/generator/payformat
Se debe incluir el Token en el Header Authorization de la siguiente manera:
| Key | Value | Descripción |
| Authorization | {{TOKEN}} | Método de autenticación de usuarios |
Utilizar el método Http.Post
Recibe un JSON con la siguiente estructura:
| Nombre del Campo | Tipo del Valor | Descripción |
| Description | Alfanumérico | Descripción de la Referencia |
| Amount | Numérico incluye decimales | Monto a pagar |
| Account | Numérico | Cuenta o Cliente |
| CustomerEmail | Alfanumérico OPCIONAL | Correo del Cliente |
| CustomerName | Alfanumérico OPCIONAL | Nombre del cliente |
| ExpirationDate | Alfanumérico OPCIONAL | Fecha de Expiración |
| RequestClabe | Falso/Verdadero | Solicitar CLABE |
| RequestPayTD | Falso/Verdadero | Solicitar URL para pago con tarjeta de crédito/débito |
ExpirationDate tiene la condición que si las especificaciones de la referencia lo incluye, previamente acordadas en contrato, es obligatoria cuando no es necesaria se manda un “null”
Amount si se quiere representar un número con decimales 152.30 este será: 15230, los últimos 2 dígitos representan los decimales
Responde un JSON con la siguiente estructura:
| Nombre del Campo | Tipo del Valor | Descripción |
| Reference | Numérico | Referencia generada |
| BarCode | Alfanumérico (URL) | Código de barras generado |
| PayFormat | Alfanumérico (URL) | Formato de pago generado |
| Message | Alfanumérico | Mensaje del resultado de la solicitud |
| Error | Alfanumérico | Mensaje de error de la solicitud |
| Folio | Numérico | Identificador de la operación |
| Date | Fecha | Fecha de la solicitud |
| Clabe | Numérico | CLABE |
| PaymentTD | Alfanumérico (URL) | Liga para pago con tarjeta de crédito/débito |
Ejemplo de Solicitud :
var options = new RestClientOptions("") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("https://qa.clubpago.site/referencegenerator/svc/generator/reference", Method.Post); request.AddHeader("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM"); request.AddHeader("Content-Type", "application/json"); var body = @"{ " + "\n" + @"""Description"": ""Test"", " + "\n" + @"""Amount"": 10000, " + "\n" + @"""Account"": ""12345"", " + "\n" + @"""CustomerEmail"": ""qa_it@clubpago.mx"", " + "\n" + @"""CustomerName"": ""Ricardo Carranza"", " + "\n" + @"""ExpirationDate"": ""2024-12-30"", " + "\n" + @"""RequestClabe"": 1, " + "\n" + @"""RequestPayTD"": 1 " + "\n" +
Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.post("https://qa.clubpago.site/referencegenerator/svc/generator/reference") .header("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM") .header("Content-Type", "application/json") .body("{\r\n\"Description\": \"Test\",\r\n\"Amount\": 10000,\r\n\"Account\": \"12345\",\r\n\"CustomerEmail\": \"qa_it@clubpago.mx\",\r\n\"CustomerName\": \"Ricardo Carranza\",\r\n\"ExpirationDate\": \"2024-12-30\",\r\n\"RequestClabe\": 1,\r\n\"RequestPayTD\": 1\r\n}") .asString();
<?php$curl = curl_init();curl_setopt_array($curl, array( CURLOPT_URL => 'https://qa.clubpago.site/referencegenerator/svc/generator/reference', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS =>'{ "Description": "Test", "Amount": 10000, "Account": "12345", "CustomerEmail": "qa_it@clubpago.mx", "CustomerName": "Ricardo Carranza", "ExpirationDate": "2024-12-30", "RequestClabe": 1, "RequestPayTD": 1 }', CURLOPT_HTTPHEADER => array( 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM', 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response;
curl --location 'https://qa.clubpago.site/referencegenerator/svc/generator/reference' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IldFRE9PWCIsIkVtaXNvcklkIjoiMzc2IiwianRpIjoiNGE5YThmMWYtOTNhZC00OTlkLWI2NWMtYTk2ZDI2YTFkMjVlIiwiVXNlcklkIjoiMzgyIiwiSXNBZG1pbiI6IkZhbHNlIiwiVXNlck5hbWUiOiJXRURPT1giLCJuYmYiOjE3NzI0OTM3NjksImV4cCI6MTc3MjUzNjk2OSwiaXNzIjoiY2x1YnBhZ28ubXgiLCJhdWQiOiJjbHVicGFnby5teCJ9.6k-uOkjiipoQOQTNvXD7gckfggBTOnwstPpFyKe95YM' \
--header 'Content-Type: application/json' \--data-raw '{
"Description": "Test",
"Amount": 10000,
"Account": "12345",
"CustomerEmail": "qa_it@clubpago.mx",
"CustomerName": "Ricardo Carranza",
"ExpirationDate": "2024-12-30",
"RequestClabe": 1,
"RequestPayTD": 1
}'
Ejemplo de Respuesta Exitosa :
{
“Reference”: “777370000000123457”,
“BarCode”: “https://qa.clubpago.site/referencegenerator/Barcodes/12345_450748.png”,
“PayFormat”: “https://qa.clubpago.site/referencegenerator/Payformat/12345_450748.pdf”,
“Message”: “Exitosa”,
“Error”: null,
“Folio”: “450748”,
“Date”: “2026-03-03T11:17:33.8471549-06:00”,
“Clabe”: “646180227790156651”,
“PaymentTD”: “https://qa.clubpago.site/referencegenerator/450748”,
“Amount”: “100.000000”,
}
RESULTADO REFERENCIA CLUBPAGO: 777370000000123457
Ejemplo de Respuesta Fallida :
{
“Reference”: “”,
“BarCode”: null,
“PayFormat”: null,
“Message”: “Error en Referencia”,
“Error”: “El monto es menor al monto mínimo configurado | Monto Mínimo: 20.000000”,
“Folio”: “450744”,
“Date”: “2026-03-03T10:46:31.8239289-06:00”,
“Clabe”: null,
“PaymentTD”: “”,
“Amount”: “1.000000”,
}
Complementos a esta funcionalidad
CLUBPAGO cuenta con un Sandbox (Ambiente de pruebas) que te ayudará a probar el GENERADOR DE REFERENCIAS. Solicita tus accesos y el Documento de Guía de uso del Sanbox de la Plataforma Tecnológica de CLUBPAGO
