The usaepya API is RESTful, well-documented, and ready for production in minutes. No hidden quirks, no undocumented endpoints — just clean, predictable responses every time.
Four clear steps — no fluff, no friction. Follow along and you'll be processing real transactions before your coffee gets cold.
Sign up in seconds — no credit card required. Once verified, your dashboard automatically provisions a pair of sandbox keys: a publishable key for client-side use and a secret key for server-to-server requests. Sandbox mode mirrors production behavior exactly, so everything you test here will work identically in live.
Call the POST /v1/transactions endpoint with an amount (in the smallest currency unit, e.g. cents) and a currency. A successful response returns a transaction object with a unique ID you can store, query, and refund at any time.
curl -X POST https://api.usaepya.com/v1/transactions
-H "Authorization: Bearer sk_test_your_api_key"
-H "Content-Type: application/json"
-d '{
"amount": 4999,
"currency": "USD",
"description": "Order #1042",
"customer": {
"email": "[email protected]"
}
}'Register a public HTTPS endpoint in your dashboard under Settings → Webhooks. usaepya will POST signed JSON payloads for events like transaction.succeeded, transaction.failed, and refund.created. Always verify the usaepya-signature header before processing.
// Express.js webhook handler example
const express = require('express');
const app = express();
app.post('/webhooks/usaepya', express.raw({ type: 'application/json' }), (req, res) => {
const sig = req.headers['usaepya-signature'];
let event;
try {
event = usaepya.webhooks.constructEvent(
req.body, sig, 'whsec_your_webhook_secret'
);
} catch (err) {
return res.status(400).send(`Webhook Error: ${err.message}`);
}
if (event.type === 'transaction.succeeded') {
const txn = event.data.object;
console.log('Payment succeeded:', txn.id);
}
res.json({ received: true });
});Once your sandbox integration is solid, swap your sk_test_ keys for sk_live_ keys — that's the only code change you'll need. Complete a brief identity verification in the dashboard, update your webhook endpoint to your production URL, and you're live. Our infrastructure handles PCI-DSS compliance, TLS termination, and 99.99{c9d393b960216dbb9db132348d5880c342a083d2ef1fb7028e68a85ef7377326} uptime SLA automatically.
Ready to go deeper?
Explore the full API reference — every endpoint, parameter, and error code, documented in detail.
usaepya's REST API is organized around three core endpoint families. Each surface follows the same predictable conventions — JSON in, JSON out, consistent error codes, and versioned stability.
Sale · Auth · Void · Refund
Initiate, authorize, capture, and reverse payments with a single, predictable API surface. Supports card-present and card-not-present flows, multi-currency, and 3DS2 authentication out of the box.
Key Endpoints
/v1/transactions/saleCharge a card immediately/v1/transactions/authPre-authorize & capture later/v1/transactions/voidCancel an unsettled auth/v1/transactions/refundFull or partial refundStore Cards · Recurring Billing
Vault card data as reusable tokens without touching raw PAN data on your servers. Build subscription flows, one-click checkout, and scheduled billing triggers with full lifecycle management.
Key Endpoints
/v1/customersCreate a customer profile/v1/customers/:id/tokensTokenize a payment method/v1/subscriptionsSet up recurring billing/v1/tokens/:token_idRevoke a stored tokenSettlements · Batches · Disputes
Pull granular settlement data, query batch history by date range or merchant ID, and programmatically manage disputes and chargebacks — all exportable as JSON or CSV.
Key Endpoints
/v1/settlementsList settled transactions/v1/batches/:batch_idFetch batch detail/v1/disputesList open disputes/v1/disputes/:id/respondSubmit dispute evidenceReady to start integrating?
Your API keys are waiting. Explore the interactive sandbox in the full developer portal.
Payments Built for Developers, Trusted by Merchants.
Get the latest API updates, developer news, and payment insights delivered to your inbox.
© 2026 usaepya. All rights reserved.