Ir al contenido
Logo Pagando Check Principal
  • Inicio
Productos
  • Comisiones
  • Desarrolladores
  • Contacto

Iniciar sesión

Comienza
Comienza
Logo Pagando Check Principal
  • Inicio
  • Comisiones
  • Desarrolladores
  • Pagando Check Pro
  • Check Link
  • Contacto

Iniciar sesión

Comienza
Comienza
Popular Search apiprestashop

API de pagos

  • Autenticación
  • Envío de información de forma segura
  • Servicios generales
  • Procesamiento de transacciones
  • Compra normal
  • Compra con Promoción
  • Compra con card-on-file
  • Compra con 3D-Secure
  • Cancelación
  • Devolución
  • Cierre de Check In

Plugins de pago

  • Magento
    • Instalación de módulo en Magento
  • Prestashop
    • Instalación de módulo en Prestashop
  • WooCommerce
    • Instalación de módulo en WooCommerce

Pagando Check Services

  • Conexión con Pagando Servicios
  • Autenticación
  • Configuración de dispositivo
  • Procesamiento de Operaciones
  • Hotelería y renta de autos
  • Restaurantes
  • Ventas con promoción
  • Información de las organizaciones
  • Corte de terminal
  • Uso de terminal
  • Glosario de códigos de respuesta

Integración con Pagando Check Pad

  • Arquitectura
  • Conexión con Pagando Check Pad
  • Comunicación y mensajes.
  • Inicio
  • Documentacion
  • API de pagos
  • Servicios generales
View Categories

Servicios generales

Registro de un cliente

Realiza el registro de un cliente dentro de los sistemas de Pagando Check para ser usado posteriormente en el procesamiento de una transacción. El servicio genera un identificador único del cliente que es utilizado para servicios de procesamiento de pagos. Este servicio generará registros de clientes nuevos siempre y cuando no coincida con clientes existentes previamente guardados.

A menos de que no se cuente con la información para una consulta posterior, no es necesario guardar el identificador del cliente.

Tipo de petición: POST

Ruta de petición: https://api.pagandocheck.com/v1/pagando/users/user

Headers: Autorization: Bearer <token provisto>

CampoTipoDescripciónRequerido
emailStringCorreo electrónico del cliente.true
nameStringNombre del cliente separado por espacios (máximo 30 caracteres).true
lastNameStringPrimer apellido del cliente (máximo 30 caracteres).true
secondLastNameStringSegundo apellido del cliente (máximo 30 caracteres).true
phoneStringNúmero telefónico del cliente.true
birthdayStringDía de nacimiento del cliente. (DD/MM/AAAA)true

Ejemplo de parámetros

{
	"email": "mail@gmail.com",
	"name": "Juan Manuel",
	"lastName": "Hernandez",
	"secondLastName": "Gutierrez",
	"phone": "6142345678",
	"birthday": "09/01/1990"
}

Ejemplo de respuesta

Todas las respuestas de API se encuentran homologadas para asegurar consistencia con el cliente, puedes conocer más a fondo esto en el glosario de respuestas.

Así mismo, los campos generales type, key, message, code vienen explicados en ese mismo glosario.

Respuesta exitosa

{
"type": "API_AUTHENTICATION",
"key" : "USER",
"message": "user",
"code": 1,
"data": {
	"userId": "20f6c660-e7cd-4f0a-9b97-f9d18fcc950c"
	}
}

Explicación de campos

CampoExplicación
userIdIdentificador del cliente

Respuesta con error

CódigoMensajeExplicación
1userCreación de cliente exitosa
102The email address is invalidEl formato utilizado para el email es inválido.
103Data was omitted when creating the userSe ha omitido o hubo un error en el formato de algún parámetro importante en la petición de creación de usuario.
104It was not possible to associate the user with the organizationHubo un problema al asignar el cliente agregado a la organización.
107Authorization header not foundNo se mando el token de autorización en la cabecera de la petición.

Tokenización de tarjeta

Para realizar el procesamiento de una transacción requiere la tokenización previa de la tarjeta con la que realizara el pago. Este es un procedimiento para reforzar la seguridad de las transacciones.

Para realizar esta petición es necesario realizar una creación de cliente previo.

Tipo de petición: POSt

Ruta de petición: https://api.pagandocheck.com/v1/pagando/payment_methods/add_card

Headers: Autorization: Bearer <token provisto>

Parámetros

CampoTipoDescripciónRequerido
userIdStringIdentificador del cliente al que pertenece la tarjetatrue
panStringLos 15 ó 16 dígitos de la tarjeta a tokenizartrue
cvvString3 o 4 dígitos del código de validación que se encuentra al reverso de la tarjetatrue
exp_monthStringMes de expiración de la tarjeta expresado en dos números.true
exp_yearStringAño de expiración de la tarjeta expresado en 2 dígitos.true
nameStringNombre del tarjetahabiente como viene en la tarjeta, no debe de contener números.true
streetStringCalle del domicilio registrado en la tarjetafalse
noExtStringNúmero exterior del domicilio registrado en la tarjetafalse
districtStringColonia del domicilio registrado en la tarjetafalse
zipCodeStringCódigo postal del domicilio registrado en la tarjetafalse
cityStringCiudad del domicilio registrado en al tarjetafalse
stateStringEstado del domicilio registrado en la tarjetafalse
CountryStringPaís en el que se emitió la tarjeta, el cual debe de ser enviado en formato ISO 3166false

Ejemplo de parámetros

{
	"userId":  "e13452da-847d-4281-ae3a-96cb8e6d35c5",
	"pan":  "1111111111111111",
	"cvv":  "171",
	"exp_month":  "02",
	"exp_year":  "23",
	"name":  "FRANCISCO TORRES BENAVIDES",
	"street":  "Diego Rivera",
	"noExt":  "720",
	"district":  "Insurgentes",
	"zipCode":  "31104",
	"city":  "Chihuahua",
	"state":  "Chihuahua",
	"country":  "MX"
}

Ejemplo de respuesta

Todas las respuestas de API se encuentran homologadas para asegurar consistencia con el cliente, puedes conocer más a fondo esto en el glosario de respuestas.

Así mismo, los campos generales type, key, message, code vienen explicados en ese mismo glosario.

Respuesta exitosa

{
"type": "API_CARD",
"key" : "NEW_CARD",
"message":  "The card has been successfully registered.",
"code": 33,
"data": {
	"cardId": "cd_udplmzrbm-re7u9b",
	"brand":  "MASTERCARD"
	}
}

Explicación de campos

CampoExplicación
cardIdIdentificador de la tarjeta tokenizada
brandMarca de la tarjeta registrada

Respuesta con error

{
	"type":  "API_AUTHENTICATION",
	"key":  "USER_ID_INVALID",
	"message":  "There is no user for the provided userId",
	"code":  101,
	"data":  null,
	"error":  true
}

Posibles códigos de respuesta

CódigoMensajeExplicación
33The card has been successfully registered.Creación de tarjeta exitosa.
200The card number is invalid. Check the card details or use a different card.El formato del número de la tarjeta no es válido o no fue recibido.
201The card’s security code is invalid. Check the card’s security code or use a different card.El formato del cvv proporcionado es inválido o no fue recibido.
202The name of the card does not match the name of the record provided.El nombre del usuario dado de alta y el nombre proporcionado para la tarjeta no coinciden.
203Could not assign card to selected user.Hubo un problema al asignar la tarjeta al cliente.
204The card information is not correct.Hubo un error de formato en los campos de mes y año de expiración, o no se recibieron al dar de alta la tarjeta.
205Missing card address information in request.Se ha omitido o hubo algún error en el formato de los parámetros que corresponden a la dirección de la tarjeta cuando la misma se intentaba guardar.
¿Te ha resultado útil?
Envío de información de forma seguraProcesamiento de transacciones
guest
guest
0 Comentarios
Más antiguo
Más reciente Más votado
Comentarios en línea
Ver todos los comentarios
En este artículo
  • Registro de un cliente
    • Ejemplo de parámetros
    • Ejemplo de respuesta
    • Respuesta exitosa
    • Explicación de campos
    • Respuesta con error
  • Tokenización de tarjeta
    • Parámetros
      • Ejemplo de parámetros
    • Ejemplo de respuesta
      • Respuesta exitosa
      • Explicación de campos
      • Respuesta con error
      • Posibles códigos de respuesta

¿Ya lo decidiste? Contacta a ventas

Contáctanos al correo ventas@pagandocheck.com o al teléfono (800) 323 0709 desde el interior de la república.

Imagen soporte Pagando
Logo Pagando Check Footer

Vendes más, seguro.

  • PRODUCTOS
  • Check Link
  • Terminal de Pagos
  • API de Pagos
  • Plugin de Pagos
  • EMPRESA
  • Aviso de Privacidad
  • Términos y Condiciones
  • Folleto Informativo
  • SOPORTE
  • Contacto
  • Preguntas Frecuentes
  • UNE

PAGANDO CHECK® incluyendo todos los derechos de propiedad intelectual del sitio web signos distintivos, dibujos, diseños, fotografías, imágenes, información, textos, música, videos, obras autorales y artísticas, materiales y demás contenido son propiedad de XC Networks, S.A. de C.V. Institución de Fondos de Pago Electrónico, y usados por Black Labs, S.A. de C.V. en su carácter de licenciatario autorizado.
XC Networks, S.A. de C.V. Institución de Fondos de Pago Electrónico © 2024 todos los derechos reservados.

Pagando Check utiliza cookies para brindarte la mejor experiencia. Al continuar
navegando en nuestro sitio aceptas nuestra Política de Uso de Cookies
Entendido
Manage consent

Privacy Overview

This website uses cookies to improve your experience while you navigate through the website. Out of these, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may affect your browsing experience.
Necessary
Siempre activado
Necessary cookies are absolutely essential for the website to function properly. These cookies ensure basic functionalities and security features of the website, anonymously.
CookieDuraciónDescripción
cookielawinfo-checkbox-analytics11 monthsThis cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Analytics".
cookielawinfo-checkbox-functional11 monthsThe cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional".
cookielawinfo-checkbox-necessary11 monthsThis cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary".
cookielawinfo-checkbox-others11 monthsThis cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Other.
cookielawinfo-checkbox-performance11 monthsThis cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Performance".
viewed_cookie_policy11 monthsThe cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data.
Functional
Functional cookies help to perform certain functionalities like sharing the content of the website on social media platforms, collect feedbacks, and other third-party features.
Performance
Performance cookies are used to understand and analyze the key performance indexes of the website which helps in delivering a better user experience for the visitors.
Analytics
Analytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics the number of visitors, bounce rate, traffic source, etc.
Advertisement
Advertisement cookies are used to provide visitors with relevant ads and marketing campaigns. These cookies track visitors across websites and collect information to provide customized ads.
Others
Other uncategorized cookies are those that are being analyzed and have not been classified into a category as yet.
GUARDAR Y ACEPTAR
¿Cuál plugin quieres instalar?
WooCommerce pluginMagento pluginPrestaShop plugin
Bancos Participantes

Bancos participantes
Bancos participantes
Bancos participantes