Desarrolladores
Referencia de la API
POST /payment/init

POST /payment/init

Crea una transacción con tarjeta y devuelve la reference + los datos para el fingerprint del dispositivo. Es el primer paso del flujo de tarjeta.

Auth: requiere x-wpay-key.

Request

CampoTipoRequeridoDescripción
namestring✅Nombre visible de la transacción (ej. "Pedido #1042").
amountnumber✅Monto a cobrar.
id_currencynumber✅1 = Bolivianos (BOB) · 2 = Dólares (USD).
order_idstring—Tu identificador interno del pedido; vuelve en el estado y webhooks.
descriptionstring—Descripción de la compra.
id_citynumber—Ciudad (catálogo interno).
id_countrynumber—País (catálogo interno).
metadataobject—JSON libre; se almacena junto a la transacción.

Response 201

{
  "reference": "WP-1784169095747-578AFA46",
  "status": "PENDIENTE",
  "msg": "TRANSACTION_CREATED",
  "fingerprint": {
    "org_id": "<org-id-del-ambiente>",
    "merchant_id": "<tu-merchant-id>"
  }
}
  • reference — identificador de la transacción para todo el flujo posterior.
  • fingerprint.org_id — identificador para el fingerprint antifraude. Cambia según el ambiente: úsalo tal como llega, sin hardcodearlo.

Errores

HTTPMensaje
400name, amount e id_currency son requeridos
401Se requiere el header x-wpay-key / Clave inválida o sistema inactivo

Pruébalo

POST/payment/init⚡ Simulador — se ejecuta en tu navegador
Ver cURL equivalente (producción)
curl -X POST "https://api.wizpay.app/payment/init" \
  -H "x-wpay-key: wpk_sandbox_demo" \
  -H "Content-Type: application/json" \
  -d '{ "order_id": "ORD-1042", "name": "Pedido #1042", "description": "Compra online", "amount": 350, "id_currency": 1, "metadata": { "cart_id": 88 } }'
ReembolsosPOST /payment/auth-setup