Ambientes

TAYPI ofrece dos ambientes separados para desarrollo y produccion.

Comparacion

Caracteristica	Sandbox	Produccion
URL base	https://sandbox.taypi.pe	https://app.taypi.pe
Panel	sandbox.taypi.pe	app.taypi.pe
Public Key	taypi_pk_test_ + 32 hex	taypi_pk_live_ + 32 hex
Secret Key	taypi_sk_test_ + 64 hex	taypi_sk_live_ + 64 hex
Dinero real	No	Si
QR funcional	Simulado	Conectado a la CCE
Webhooks	Se envian normalmente	Se envian normalmente
Rate limit	60 req/min	60 req/min
Cuentas	Separadas	Separadas

CLAVES DIFERENTES

Las API keys de sandbox no funcionan en produccion, y viceversa. Cada ambiente tiene sus propias claves.

Sandbox

El ambiente sandbox te permite probar tu integracion sin procesar dinero real. Los pagos se simulan y puedes probar todo el flujo completo: creacion de pagos, generacion de QR, webhooks y consultas.

URL base

https://sandbox.taypi.pe

API Keys de prueba

Registrate en sandbox.taypi.pe para obtener tus claves de prueba:

TAYPI_PUBLIC_KEY=taypi_pk_test_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
TAYPI_SECRET_KEY=taypi_sk_test_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4

Simular pagos

TAYPI incluye un simulador de wallet que funciona como una app de pagos. Puedes abrirlo desde tu celular para escanear QRs generados en sandbox.

URL del simulador:

https://sandbox.taypi.pe/simulator

Flujo de prueba

1. Crea un pago via API o SDK.
2. Abre el simulador en tu celular: sandbox.taypi.pe/simulator
3. Escanea el QR con la camara del simulador.
4. El simulador procesa el pago y tu webhook recibe la notificacion payment.completed.

CONSEJO

Abre el simulador en tu celular y tu panel en la PC. Asi puedes escanear el QR tal como lo haria un cliente real con Yape o Plin.

Limitaciones del sandbox

Limitacion	Detalle
QR no escaneable	Los QR generados en sandbox no se pueden pagar con Yape o Plin reales
Sin desembolsos	Las operaciones de desembolso se simulan, no se envian transferencias reales
Datos de prueba	Los datos del pagador (nombre, CCI) son ficticios
Sin verificacion KYB	No se requiere documentacion para subir de nivel en sandbox

TIP

El sandbox es ideal para desarrollo, testing automatizado y demos a clientes.

Produccion

El ambiente de produccion procesa pagos reales a traves de la CCE (Camara de Compensacion Electronica).

URL base

https://app.taypi.pe

Requisitos para produccion

Antes de procesar pagos reales, debes completar los siguientes pasos:

1. Verificacion KYB (Nivel 2)

Para acceder a todas las funcionalidades, completa la verificacion Know Your Business:

Documento	Descripcion
Ficha RUC SUNAT	Constancia de inscripcion vigente
DNI del representante legal	Ambas caras, vigente
Vigencia de poder	Solo para RUC 20 (personas juridicas)
Recibo de servicios	A nombre del titular, no mayor a 3 meses
CCI	Cuenta a nombre del titular del RUC
Declaracion jurada	Origen licito de fondos

2. Configuracion tecnica

Paso	Detalle
Cambiar URL base	De sandbox.taypi.pe a app.taypi.pe
Nuevas API keys	Genera claves de produccion (taypi_pk_live_*, taypi_sk_live_*)
Webhook URL	Configura tu endpoint de produccion (debe ser HTTPS)
Test end-to-end	Realiza al menos un pago de prueba real

3. Checklist pre-lanzamiento

Verifica que tu integracion cumple con estos puntos antes de ir a produccion:

• [ ] Verificacion de firma HMAC-SHA256 implementada en tu servidor
• [ ] Webhook configurado y verificando la firma de cada entrega
• [ ] Idempotency-Key enviado en todos los requests POST
• [ ] Manejo de errores implementado (reintentos, backoff exponencial)
• [ ] Secret key almacenada de forma segura (variables de entorno, no en codigo)
• [ ] HTTPS en tu webhook URL
• [ ] Verificacion del monto en el webhook (comparar con tu orden original)
• [ ] Manejo de expirancion de QR (15 minutos)
• [ ] Probado en sandbox con todos los escenarios (pago exitoso, expirado, error)

Configuracion por ambiente

PHP (Laravel)

// config/services.php
'taypi' => [
    'public_key' => env('TAYPI_PUBLIC_KEY'),
    'secret_key' => env('TAYPI_SECRET_KEY'),
    'sandbox' => env('TAYPI_SANDBOX', true),
],

# .env (sandbox)
TAYPI_PUBLIC_KEY=taypi_pk_test_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
TAYPI_SECRET_KEY=taypi_sk_test_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
TAYPI_SANDBOX=true

# .env (produccion)
TAYPI_PUBLIC_KEY=taypi_pk_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
TAYPI_SECRET_KEY=taypi_sk_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
TAYPI_SANDBOX=false

JavaScript (Node.js)

import Taypi from 'taypi.pe';

const taypi = new Taypi(
    process.env.TAYPI_PUBLIC_KEY,
    process.env.TAYPI_SECRET_KEY,
    { sandbox: process.env.TAYPI_SANDBOX === 'true' },
);

C# (.NET)

var client = new TaypiClient(
    publicKey: configuration["Taypi:PublicKey"]!,
    secretKey: configuration["Taypi:SecretKey"]!,
    options: new TaypiOptions
    {
        Sandbox = configuration.GetValue<bool>("Taypi:Sandbox"),
    }
);

Preguntas frecuentes

¿Puedo usar las mismas credenciales en ambos ambientes?

No. Cada ambiente tiene sus propias API keys. Las claves de sandbox (test) no funcionan en produccion (live) y viceversa.

¿Los webhooks funcionan igual en ambos ambientes?

Si. Los webhooks se envian de la misma forma en sandbox y produccion, incluyendo la firma HMAC-SHA256 y la politica de reintentos.

¿Hay limites diferentes en produccion?

Los rate limits son iguales (60 req/min). Los limites de monto dependen de tu nivel de comercio:

Nivel	Limite mensual
Nivel 1 (basico)	S/ 10,000/mes
Nivel 2 (verificado)	S/ 50,000/mes

¿Como pruebo webhooks en mi maquina local?

Usa ngrok para exponer tu servidor local:

ngrok http 3000

Copia la URL HTTPS que ngrok te da (ejemplo: https://abc123.ngrok.io) y configurala como webhook URL en el panel sandbox.