Migrating from Airwallex

Airwallex and Qualy both lean on multi-currency collection, so most of your integration maps one to one. The big difference is what happens after the money arrives: in Qualy you declare who gets paid (schools, agents, suppliers) on the payment itself, and Qualy pays them out.

Concept map

Authentication

Airwallex exchanges a client id and API key for a short-lived token. Qualy needs no token exchange: send the API key on every request.

curl https://api.qualyhq.com/v1/payment-intents \
  -H 'Authorization: ApiKey your-api-key-here' \
  -H 'X-TENANT-ID: your-tenant-id-here'

Payment Links

const res = await fetch('https://api.airwallex.com/api/v1/pa/payment_links/create', {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    amount: 1350.0,
    currency: 'AUD',
    title: 'Tuition fee',
    reusable: false,
  }),
});

const res = await fetch('https://api.qualyhq.com/v1/payment-intents/create', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'ApiKey your-api-key-here',
    'X-TENANT-ID': 'your-tenant-id-here',
  },
  body: JSON.stringify({
    intentType: 'ad-hoc',
    number: 'INV-2026-0042', // your own reference
    contact: 'john.doe@example.com',
    currency: 'AUD',
    dueAt: '2026-12-01T00:00:00.000Z',
    items: [{ name: 'Tuition fee', amount: 135000 }],
  }),
});

const { data: payment } = await res.json();
console.log(payment.links.short);

This is a one-off link for one student. For a reusable: true Airwallex link, use a public service with a price template instead. See Payment links.

Collecting in the student's currency

With Airwallex you collect in one currency and convert. In Qualy you invoice in your currency and let the student pay in theirs:

body: JSON.stringify({
  intentType: 'ad-hoc',
  contact: 'joao@example.com',
  currency: 'AUD',            // what you invoice
  settlementCurrency: 'BRL',  // what the student pays in (optional)
  items: [{ name: 'Tuition fee', amount: 135000 }],
}),

Leave settlementCurrency out and the student chooses on the portal. The currency decides which local methods appear (PIX and boleto for BRL, PayID for AUD, and so on). See Collecting payments.

Payouts → splits

Instead of creating a Transfer to a Beneficiary after the money arrives, attach splits to the payment. Each partnership has its bank details on file; Qualy pays them once the student's payment settles.

await fetch('https://api.qualyhq.com/v1/payment-splits/create', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'ApiKey your-api-key-here',
    'X-TENANT-ID': 'your-tenant-id-here',
  },
  body: JSON.stringify({
    type: 'percentage-on-amount',
    currency: 'AUD',
    amount: 40500,
    percentage: 0.3,
    partnership: 'usyd',
    contact: 'john.doe@example.com',
    paymentIntent: '661e9bbfe0eb901d6b2f2670',
    item: '661e9bc0e0eb901d6b2f2682',
  }),
});

To see the payouts first, use POST /v1/payment-splits/preview. For many payments at once, see Bulk payment splits.

Webhooks

See Webhook events for payloads.