Saltar al contenido principal

Tu primer pago, en cinco minutos

Cuatro comandos y un clic. Al final vas a haber recibido un pago de prueba contra el simulador, sin dinero real y sin credenciales en vivo.

No hay nada que elegir ni que instalar. Copia, pega, y sigue.

1 · Crea Tu Cuenta de Prueba​

curl -sX POST https://devsim.mispidi.com/console/register \
 -H "Content-Type: application/json" \
 -d '{"email":"tu@correo.test","password":"lo-que-quieras"}'

Guarda el token que viene dentro de key. Es lo único que necesitas de aquí.

2 · Di a Dónde Va el Dinero​

curl -sX POST https://devsim.mispidi.com/api/v1/ext/agreements \
 -H "Authorization: Bearer TU_TOKEN" -H "Content-Type: application/json" \
 -d '{"title":"Mi primer acuerdo","split":false,
      "payment_methods":{"immediate_debit":true,"mobile_payment":true,"crypto":false},
      "default_bank_account_id":"uuid_sofitasa_001"}'

Guarda el agreement_id de la respuesta. Esto se hace una vez, no en cada pago.

3 · Crea la Sesión de Pago​

curl -sX POST https://devsim.mispidi.com/api/v1/ext/payment-sessions/buttons \
 -H "Authorization: Bearer TU_TOKEN" -H "Content-Type: application/json" \
 -d '{"agreement_id":"TU_AGREEMENT_ID","amount_reference":150,"currency_reference":"VES",
      "identifier_label":"Cedula","identifier":"V12345678","description":"Mi primer pago",
      "success_url":"https://example.com/ok","failure_url":"https://example.com/no",
      "duration_minutes":20}'

Guarda la payment_url.

4 · Paga​

Abre esa payment_url en el navegador. Rellena lo que te pida y, cuando llegue el momento de la clave de pago, escribe 000000.

Ya está: acabas de recibir tu primer pago.

5 · Compruébalo​

curl -s https://devsim.mispidi.com/api/v1/ext/payment-sessions/status/TU_SESSION_ID \
 -H "Authorization: Bearer TU_TOKEN"

Verás status: paid. El session_id es el que te devolvió el Paso 3.

Y Ahora Sí, el Porqué​

Lo que acabas de hacer tiene tres piezas, y conviene entenderlas antes de llevarlo a tu aplicación:

  • El acuerdo es la configuración de a dónde va el dinero. Se crea una vez y se reutiliza. → Los conceptos
  • La sesión es un pago concreto, con su enlace y su caducidad. → Ciclo de vida
  • paid no es que te llegó el dinero. Hay un segundo tiempo, la acreditación, y es el que cuenta para conciliar. → Los dos tiempos

Y falta la pieza que aquí nos saltamos a propósito: cómo te enteras de un pago sin estar mirando. Eso son los avisos firmados, y es lo que hace el tutorial completo.

→ Recibe tu primer pago — el mismo camino, entero: con tu servidor recibiendo el aviso y verificando la firma.