Descargas
La colección y el environment de modo prueba. El environment no trae llaves.
Empieza en cuatro pasos
- Descarga los archivos. La colección y el environment de modo prueba. El environment no trae llaves.
- Impórtalos en Postman. En Postman, elige Import y arrastra los dos archivos.
- Configura tu llave de prueba. Selecciona el environment HelppiuPay · Modo prueba y completa
api_key_idyapi_key_secretcon una llavehp_sk_test_…que crees en tu panel, en Llaves API. Usa solo llaves de prueba: las llaves live mueven dinero real. - Haz tu primer request. Abre Catalogs y envía la consulta de bancos PSE. Si responde
401, revisa que la llave tenga el formatokey_id:secret.
GET {{baseUrl}}/api/v1/banks/pse
Authorization: Bearer {{api_key_id}}:{{api_key_secret}}Qué incluye
| Carpeta | Contenido | Requests |
|---|---|---|
| Tokens | Tokenizar tarjetas | 1 |
| Charges | Cobros directos | 3 |
| Saved Cards | 2 | |
| Checkout Sessions | Checkout hospedado | 3 |
| Payouts | Payouts Bre-B | 4 |
| Wallet | Bolsillo y llaves autorizadas | 7 |
| Transactions | Transacciones | 2 |
| Webhook Endpoints | Endpoints de webhook | 3 |
| Catalogs | Bancos PSE y tasas de cambio | 2 |
Las tarjetas guardadas todavía no están en la colección; puedes verlas en la referencia.
Variables
| Variable | Uso |
|---|---|
baseUrl | https://helppiupay.com. Es la misma en modo prueba y en producción. |
api_key_id | Identificador de tu llave, por ejemplo hp_sk_test_…. |
api_key_secret | Secreto de la llave. Se guarda como variable secreta. |
Para verificar la firma de los webhooks, sigue la guía de webhooks. Colección generada con php artisan docs:export-postman desde el contrato del 2026-11-13.