Payments

Pay-as-you-go credit top-ups via vouchers.


const rate = await client.payments.rate()
console.log(rate.minAmountTzs, rate.tiers)
 
const payment = await client.payments.create(
  {
    provider: 'snippe',       // or 'manual'
    amount: 10000,            // TZS — credits computed server-side
    phone: '0712345678',
  },
  { idempotencyKey: 'topup-42' }
)
console.log(payment.id, payment.status, payment.creditAmount)


GET /v1/vouchers/rate
POST /v1/vouchers

Declared-payer OTP flow

When the payer’s number differs from the account phone, verify it first:


await client.payments.sendDeclaredPhoneOtp('0765432109')
await client.payments.verifyDeclaredPhoneOtp('0765432109', '4921')


POST /v1/vouchers/otp/send
POST /v1/vouchers/otp/verify

See Payments & Vouchers for the full contract.