Developers
IPPAN Pay is API-first. Every feature available in the dashboard is accessible through a deterministic, versioned REST API with structured JSON responses, idempotent operations, and verifiable settlement proofs.
Authenticate once, build with confidence
Every request is authenticated with an API key passed via the Authorization header. Keys are scoped to specific environments and can be rotated without downtime.
import { IppanPay } from "@ippan/pay-sdk";
const client = new IppanPay({
apiKey: process.env.IPPAN_API_KEY!,
environment: "sandbox", // or "production"
});
const payment = await client.payments.create({
amount: 50000, // $500.00 in cents
currency: "USDC",
merchant_id: "mer_9x8kLm2nQp",
metadata: { order_id: "ord_abc123" },
});
console.log(payment.id); // pay_7f3dK...
console.log(payment.status); // "pending"
console.log(payment.proof_url); // deterministic proof URISDKs for every stack
First-party libraries with typed models, automatic retries, idempotency helpers, and webhook signature verification built in.
Ship faster with a full sandbox environment
The IPPAN Pay sandbox mirrors production exactly -- deterministic settlement, webhook delivery, proof generation, and replay verification -- with zero real-money risk. Test cards, simulated bank transfers, and configurable failure scenarios are available out of the box.
Full parity
Sandbox endpoints behave identically to production. Settlement finality, proof URIs, and webhook payloads use the same schemas.
Separate keys
Sandbox and production API keys are issued independently. No chance of accidental live transactions during development.
CLI tooling
Use the IPPAN CLI to trigger test events, inspect settlement proofs, and tail webhook logs without leaving your terminal.