Instalación

Sandbox via API

Para pruebas via API recomendamos utilizar POSTMAN

Estructura de Headers

Para utilizar el Sanbox vía API primero se deben configurar los headers.

Header Valor
x-auth-key: 1234567890
x-auth-hash: 36cdf8271723276cb6f94904f8bde4b6
Accept: application/json

Headers con Postman

URLs para request por tipo de transacción

Para realizar las pruebas en Sandbox, se deben utilizar las siguientes URLs

URL Tipo de cobro Metodo
https://pixelpay.dev/api/v2/transaction/sale SALE POST
https://pixelpay.dev/api/v2/transaction/auth AUTH POST
https://pixelpay.dev/api/v2/transaction/capture CAPTURE POST
https://pixelpay.dev/api/v2/transaction/void VOID POST

URLs para request de tokenización

Para realizar las pruebas en Sandbox, se deben utilizar las siguientes URLs

URL Tipo Metodo
https://pixelpay.dev/api/v2/tokenization/card Tokenizar tarjeta POST
https://pixelpay.dev/api/v2/tokenization/card/{token} Editar tarjeta PUT
https://pixelpay.dev/api/v2/tokenization/card/{token} Obtener información de tarjeta GET
https://pixelpay.dev/api/v2/tokenization/card/{token} Eliminar tajeta DELETE

Los las tarjetas tokenizadas solo son válidas durante 5 horas, después de este tiempo se eliminan automáticamente.

Sandbox via SDK

Para simplificar las integraciones, PixelPay proporciona un SDK Web/NodeJS.

El SDK brinda una forma sencilla para hacer el envío de los datos de cobro y evita el redireccionamiento al sitio web del proveedor para completar el proceso de pago.

Implementación

El SDK puede ser implementado via NPM o por CDN, a continuación te dejamos los paquetes oficiales:

Package Oficial NPM: https://www.npmjs.com/package/@pixelpay/sdk-core

Package Oficial CDN: https://cdn.jsdelivr.net/npm/@pixelpay/sdk-core

// ES5 Import
import * as PixelPay from '@pixelpay/sdk-core';

// - o -

// CDN
<script src="https://cdn.jsdelivr.net/npm/@pixelpay/sdk-core"></script>
...

// Se instancia el setup del Sandbox
var settings = new Models.Settings();
settings.setupSandbox();

Como vemos en el ejemplo, se debe instanciar el setupSandbox() para cambiar el enviroment del SDK a Sandbox

Datos Generales

Tarjetas permitidas en Sandbox

Para realizar las pruebas en Sandbox, solo debes utilizar las siguientes tarjetas de crédito / débito

Number Brand CVV Exp Date
4111111111111111 VISA 300 2512
5555555555554444 MASTERCARD 999 2512

Casos de Prueba

El ambiente sandbox permite simular distintos tipos de transacciones. Para elegir el tipo de respuesta a recibir es necesario modificar el valor del campo order_amount dentro de la petición, cada monto generará un caso distinto, las respuestas son:

Valor de campo order_amount Respuesta
1 Transacción Exitosa
2 Transacción declinada
3 Configuración de comercio inválida
4 Tarjeta Con Reporte de robo o Extravío
5 Error al encontrar cobro
6 El límite de intentos ha sido superado
7 Error general del Sistema
8 Error Timed Out
9 Monto de transacción Excedido
10 Límite de transacciones Excedido
11 Límite por monto de transacciones Excedido
12 Límite por número de Bin
13 Límite por tipo de Tarjeta
14 Límite por Localización

Casos de prueba para 3-D Secure 2.x

Los siguientes casos de prueba se pueden usar para probar la autenticación 3-D Secure para cada marca compatible.

Estas transacciones solo funcionan con el Caso #1 de Sandbox y solamente se debe de reemplazar la tarjeta.
Caso Visa Mastercard
(2.1) Successful Authentication 4000000000001000 5200000000001005
(2.2) Failed Authentication 4000000000001018 5200000000001013
(2.3) Attempts Stand-In Authentication 4000000000001026 5200000000001021
(2.4) Unavailable Authentication from the Issuer 4000000000001034 5200000000001039
(2.5) Rejected Authentication by the Issuer 4000000000001042 5200000000001047
(2.6) Authentication Not Available on Lookup 4000000000001059 5200000000001054
(2.7) Error on Lookup 4000000000001067 5200000000001062
(2.8) Timeout on cmpi_lookup Transaction 4000000000001075 5200000000001070
(2.9) Successful Step Up Authentication 4000000000001091 5200000000001096
(2.10) Failed Step Up Authentication 4000000000001109 5200000000001104
(2.11) Step Up Authentication is Unavailable 4000000000001117 5200000000001112
(2.12) Error on Authentication 4000000000001125 5200000000001120