Quickstart

Accept your first ACH payment in three steps. Use a sk_test_ key while building — no real money moves.

1. Create a payment

curl https://api.wiredx.live/v1/payments \
  -H "Authorization: Bearer sk_test_..." \
  -d amount=12000 \
  -d customer_email=ana@example.com \
  -d description="Order #1042"
{
  "id": "6f1c...",
  "status": "requires_payment",
  "amount": 12000,
  "fee": 42,
  "checkout_url": "https://wiredx.live/checkout/6f1c..."
}

2. Send the customer to checkout

Redirect to checkout_url, or embed the widget:

<script src="https://js.wiredx.live/v1.js"></script>
<button onclick="Wiredx.checkout({ payment: '6f1c...' })">
  Pay by bank
</button>

3. Listen for webhooks

Add an endpoint under Dashboard → Developers. Events: payment.succeeded, payment.returned, payment.failed.

app.post("/webhooks/wiredx", (req, res) => {
  const event = req.body;
  if (event.type === "payment.succeeded") fulfillOrder(event.data.id);
  res.sendStatus(200);
});

Payment statuses

  • requires_payment — waiting for the customer
  • processing — debit submitted, settles in 1–3 business days
  • succeeded — funds settled
  • returned / failed — bank rejected or reversed the debit