Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.useaxra.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Option 1: Accept a payment

1

Install the Node SDK

npm install @axra/node
2

Create a payment

import { Axra } from '@axra/node';

const axra = new Axra('sk_test_...');

const payment = await axra.payments.create({
  amount: 5000,     // $50.00 in cents
  currency: 'USD',
  source: 'pm_card_visa',
});

console.log(`Payment ${payment.id}: ${payment.status}`);

​
Option 2: Treasury — build a banking product

1

Sign up as a Treasury partner

curl -X POST https://api.useaxra.com/api/v1/treasury/signup \
  -H "Content-Type: application/json" \
  -d '{"name":"My Fintech","slug":"my-fintech"}'
Save the returned secretKey (sk_test_...).
2

Create an end-user

curl -X POST https://api.useaxra.com/api/v1/treasury/users \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"externalId":"user_123","email":"jane@example.com","name":"Jane Doe"}'
3

Run KYC (sandbox auto-approves)

curl -X POST https://api.useaxra.com/api/v1/treasury/users/{id}/kyc \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"applicant":{"firstName":"Jane","lastName":"Doe","email":"approve@sandbox.useaxra.com"}}'
Using approve@sandbox.useaxra.com auto-approves in sandbox.
4

Create a wallet and fund it

# Create wallet
curl -X POST https://api.useaxra.com/api/v1/treasury/users/{id}/wallets \
  -H "Authorization: Bearer sk_test_..." \
  -d '{"currency":"NGN"}'

# Sandbox credit
curl -X POST https://api.useaxra.com/api/v1/treasury/users/{id}/wallets/{walletId}/sandbox-credit \
  -H "Authorization: Bearer sk_test_..." \
  -d '{"amount":"1000","currency":"NGN"}'

​
Sandbox fixtures

EmailKYC outcome
approve@sandbox.useaxra.comInstantly approved
reject@sandbox.useaxra.comInstantly rejected with reason
pending@sandbox.useaxra.comStays pending — use sandbox-approve to advance
Payout metadataOutcome
{ "test_outcome": "fail_insufficient_funds" }Payout fails immediately
{ "test_outcome": "delay_24h" }Payout completes after 24h delay
(none)Payout completes after 2s