API Infrastructure

API-first infrastructure for payment operations

Build cross-border commerce on a clean API surface with predictable behavior, signed webhook events, a transparent wallet ledger and orchestration across acquiring partners.

REST APIs

Predictable resource-based endpoints with idempotency, pagination and structured errors.

Webhooks

Signed, retried event delivery with replay and dead-letter handling.

Wallet ledger events

Append-only ledger streaming balances, holds and multi-currency movements.

Transaction orchestration

Smart routing across acquirers and partners through configurable rules.

Seller onboarding APIs

Programmatic KYB, sub-merchant creation and document workflows.

Settlement operations

Scheduled and on-demand settlement with rule-based splits and approvals.

Reporting endpoints

Granular reporting for transactions, balances, payouts and reconciliation.

Event-driven architecture

Authorization, capture, refund and dispute lifecycle as first-class events.

payments.http

Create a split payment

POST /v1/payments
Authorization: Bearer pxg_live_***
Content-Type: application/json
Idempotency-Key: ord_A-10293

{
  "amount": 12990,
  "currency": "USD",
  "customer": { "country": "BR" },
  "payment_method": { "type": "card" },
  "split": [
    { "account": "acct_seller_01", "amount": 11000 },
    { "account": "acct_platform",  "amount":  1990 }
  ],
  "settlement": { "currency": "USD", "schedule": "T+2" },
  "metadata": { "order_id": "A-10293" }
}

webhook.json

Handle a captured event

POST https://api.merchant.com/webhooks/pxg
PXG-Signature: t=1736294400,v1=8a7f...
Content-Type: application/json

{
  "id": "evt_01HXY...",
  "type": "payment.captured",
  "api_version": "2025-11-01",
  "data": {
    "object": {
      "id": "pay_01HXY...",
      "status": "captured",
      "amount": 12990,
      "currency": "USD",
      "ledger_entries": [
        { "account": "acct_seller_01", "amount": 11000 },
        { "account": "acct_platform",  "amount":  1990 }
      ]
    }
  }
}

Engineering principles

Designed with discipline for production environments

Low-latency APIs

Optimized for transactional workloads at scale.

Signed webhooks

HMAC-signed deliveries with versioned payloads.

Versioned & stable

Date-pinned API versions and changelog discipline.

Built for engineers

Clean error model, idempotency keys, granular scopes.