View Categories

Compra normal

Compra normal con tarjeta no presente en e-commerce realizada desde el servidor.

Tipo de petición: POST
Ruta de petición: https://api.pagandocheck.com/v1/pagando/orders/create-order
Headers: Autorization: Bearer <token provisto>

Parámetros

CampoTipoDescripciónRequerido
userIdStringIdentificador del cliente que realizara la transacción.true
amountStringMonto expresado en pesos (MXN) por el que se realizara el pago.true
cardIdStringTarjeta tokenizada con la que se ralizara el pago.true
aftTokenStringIdentificador del cliente provisto por el token de antifraude.true
pinStringSon los 3 o 4 dígitos del código de validación que se encuentran al reverso de la tarjeta.true
conceptStringConcepto de pago que se esta realizado.false
streetStringCalle del domicilio registrado en la tarjeta.false
noExtStringNo exterior del domicilio registrado en la tarjeta.false
districtStringColonia del domicilio registrado en la tarjeta.false
zipCodeStringCódigo postal del domicilio registrado en la tarjeta.false
cityStringCiudad del domicilio registrado en al tarjeta.false
stateStringEstado del domicilio registrado en la tarjeta.false
CountryStringPaís en el que se emitio la tarjeta, el cual debe de ser envíado en el ISO 3166.false
expediteShippingStringIndica si el envío de los productos se realizará al día siguiente.false
itemsArray
[ItemSchema]		Indicador de productos vendidos, solo sirve como referencia.false
externalReferenceStringIdentificador externo del cliente para seguimiento de operación, este debe cambiar por cada intento de operación.false

ItemSchema 

{
    "quantity":  1,
    "productSku":  "12345",  //Sku del producto a vender
    "productName":  "Test",  // Nombre del producto a vender
    "productType":"Unknown",  // Tipo de producto envíado
    "unitPrice":  200, // Precio unitario del producto
    "totalAmount":  200 // Total de la suma de los productos
}

Ejemplo de parámetros 

{
    "userId":"328cf8d5-0f30-46fc-XXXX-AAAAAAA",
    "amount":"200",
    "concept":"Prueba Pagando con Api normal",
    "cardId":"cd_XXXXXXXXX",
    "pin":  "063",
    "street":"Diego Rivera",
    "noExt":720,
    "district":"Insurgentes",
    "zipCode":31104,
    "city":"Chihuahua",
    "state":"Chihuahua",
    "country":"MX",
    "expediteShipping":true,
    "items":[{
        "quantity":  1,
        "productSku":  "12345",
        "productName":  "Test",
        "productType":"Unknown",
        "unitPrice":  200,
        "totalAmount":  200
    }],
}

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_ORDERS",
    "key":  "SUCCESS_ORDER",
    "message":  "The order has been successfully completed.",
    "code":  66,
    "data":  {
        "error":  false,
        "message":  "¡El pago se ha realizado exitosamente!, para descargar tu comprobante accede a tu perfil.",
        "data":  {
            "transactionNumber":  31856,
            "folio":  "PAG-000000011767",
            "reference":  "PAG-000000011767",
            "orderNumber":  5974,
            "authCode": "89484"
        }
    }
}
Explicación de campos

Dentro de la estructura de data.

CampoExplicación
error Identifica si existió algún problema con el procesamiento de transacción que no se encuentre identificado
message Mensaje sobre el procesamiento de la transacción
transactionNumber Número de transacción para su busqueda en el panel de transacciones realizadas
folioFolio de identificación de la transacción
referenceFolio de identificación de la transacción
orderNumberNúmero de orden registrada

Respuesta con error 

{
    "type":  "API_ORDERS",
    "key":  "PAYMENT_DECLINED",
    "message":  "Payment has been declined, please try again later or with another payment method.",
    "code":  305,
    "data":  {
        "error":  true,
        "message":  "Insufficient funds"
    },
    "error":  true
}

Posibles códigos de respuesta

CódigoMensajeExplicación
66The order has been successfully completed.Procesamiento de transacción correcta
71La orden requiere de revisión adicional.La transacción necesita realizar una revisión por medio de 3D Secure, con activación previa
300No payment settings found, please check your public key.El sistema de pagos en producción no ha sido liberado completamente por favor, contacta a soporte
301The payment method associated with the provided user was not found.No se recibió el identificador de tarjeta en la petición de pago.
302An error occurred and the payment could not be processed. Please try again later.Puede darse por la falta de configuración de un elemento para el procesamiento de pagos o por una configuración erronea, por favor contacta a soporte
304The amount to pay has not been specified.No se recibió el parámetro de amount en la petición de pago.
305Payment has been declined, please try again later or with another payment method.Error devuelto por la entidad bancaria, estos errores tienen que ver directamente con la tarjeta utilizada.
306None anti fraud token was found.No se envió el token antifraude en la petición de pago.
307None anti fraud token was found.No se envió el token antifraude en la petición de pago.
308The transaction has been declined due to the possibility of fraud.Este código de estatus es arrojado por nuestro sistema antifraude, por favor contacta a soporte para mas información.
320The card’s cvv has not been specified.No se recibió el parámetro de cvv en la petición.

Suscribirse
Notificar de
guest
0 Comentarios
Más antiguo
Más reciente Más votado
Comentarios en línea
Ver todos los comentarios
Ingresar
Crear cuenta