Llaves de Prueba (Sandbox)

¿Quieres probar el botón de pago de SmartPay sin crear una cuenta de comercio ni completar la verificación de Nivel 2? Usa las llaves de prueba (sandbox) compartidas que encontrarás abajo. Funcionan igual que tus propias llaves, pero operan contra el entorno de pruebas.

Llaves de Prueba Compartidas

PUBLIC_KEY = pk_test_c6649e69315edc3389a3cc439e7b0649
SECRET_KEY = sk_test_82249499f91c116a92bce2c6ab6a91133f3f1a52cb0fcfd455b5d420eb42504e

Llave	Valor	Dónde usarla
Llave Pública	`pk_test_c6649e69315edc3389a3cc439e7b0649`	Propiedad `publicKey` del componente SmartPay (frontend)
Llave Secreta	`sk_test_82249499f91c116a92bce2c6ab6a91133f3f1a52cb0fcfd455b5d420eb42504e`	Header `x-secret-key` en la llamada de preorden (backend)

El entorno de pruebas usa el mismo host de API que producción (https://pb-api.apolopay.app) — el prefijo de la llave (pk_test_ / sk_test_) es lo que selecciona el entorno de pruebas.

Pruébalo en 3 Pasos

1. Crea un preorden de prueba

curl -X POST https://pb-api.apolopay.app/payment-button/process/preorder \
  -H "Content-Type: application/json" \
  -H "x-secret-key: sk_test_82249499f91c116a92bce2c6ab6a91133f3f1a52cb0fcfd455b5d420eb42504e" \
  -d '{
    "amount": 1.00,
    "metadata": {
      "orderId": "TEST-0001",
      "customerEmail": "[email protected]"
    }
  }'

La respuesta envuelve el preorden creado en un objeto result:

{
  "success": true,
  "message": "OK",
  "result": {
    "id": "660cbb7f-6d78-4638-862b-1dbc3911ecbe",
    "amount": 1,
    "status": "pre_order",
    "createdAtMs": 1790095153955
  }
}

Campo	Descripción
`success`	`true` cuando el preorden fue creado
`message`	Estado legible (`"OK"`)
`result.id`	El process ID (UUID) que pasas al botón de pago
`result.amount`	Monto registrado para el preorden
`result.status`	`pre_order` hasta que el cliente complete el pago
`result.createdAtMs`	Timestamp de creación en milisegundos

2. Renderiza el botón

Pasa la llave pública de prueba y result.id como process-id del botón:

<payment-button
  publicKey="pk_test_c6649e69315edc3389a3cc439e7b0649"
  process-id="PROCESS_ID_FROM_BACKEND"
></payment-button>

3. Completa un pago de prueba

Interactúa con el botón, elige una criptomoneda y una red, y sigue el flujo de pago. No se mueven fondos reales.

Sandbox vs Tus Propias Llaves

	Llaves de prueba compartidas	Tus propias llaves
Llave pública	`pk_test_c6649e69315edc3389a3cc439e7b0649`	Generada en el panel
Llave secreta	`sk_test_8224...`	Generada en el panel
Requisito	Ninguno — úsalas tal cual	Cuenta verificada en Nivel 2
Para quién	Cualquiera que evalúe SmartPay	Tu integración de producción

Estas llaves son públicas y compartidas

Las llaves de prueba se publican a propósito para que cualquiera pueda probar el botón. Por eso:

Nunca las uses en producción — usa tus propias llaves desde el panel
No envíes datos sensibles en metadata ni en el flujo de pago
No apuntes webhooks reales hacia ellas y no trates los datos de prueba como privados

Tu propia llave secreta sigue siendo secreta

La regla de "nunca expongas tu llave secreta" sigue aplicando a tus llaves privadas. Esta página solo publica una llave secreta de prueba compartida. Las llaves secretas de producción nunca deben aparecer en el código del frontend, repositorios públicos ni JavaScript del lado del cliente — pertenecen únicamente a tu servidor.

Siguientes Pasos

Integración Backend → — Crea preórdenes con la llave secreta
Elige tu framework → — Renderiza el botón
Crea tu Propio Botón → — Obtén tus propias llaves

Llaves de Prueba Compartidas​

Pruébalo en 3 Pasos​

1. Crea un preorden de prueba​

2. Renderiza el botón​

3. Completa un pago de prueba​

Sandbox vs Tus Propias Llaves​

Siguientes Pasos​