Pay QR codes like a local across Asia, Africa and Latin America.

Version 2.0 Beta
View as Markdown

This collection includes all HTTP endpoints for the SQRIL SaaS payout system:

  • Customer registration and profile management (registerCustomer/checkCustomer/updateCustomer)
  • QR code decoding (decodeQr)
  • Payout execution (executePayout)
  • Payment provider integrations
  • Transaction management
  • Account webhook notifications

Currency precision (request amounts)
Pass amounts as JSON numbers in standard currency units:

CurrencyDecimal placesExample
IDR0100000.00 = 100,000 IDR
PHP21000.50 = 1,000.50 PHP
VND01000000.00 = 1,000,000 VND
USD2100.00 = 100.00 USD

decodeQr, getQuotation, and executePayout response formatting

USD fields in JSON responses from those endpoints:

  • fee (total SaaS fee in USD), percentage_fee, fixed_fee, amount_usd: 2 decimal places
  • exchange_rate: 10 decimal places (source currency → USD)

Where pricing is returned, fee equals percentage_fee + fixed_fee (within rounding). Older transactions may omit the breakdown.

Stored transaction data may keep higher precision; these limits apply to the HTTP response body.

All endpoints are RESTful HTTP endpoints.

Customer flow (required):

  1. Call registerCustomer and store the returned customer_id.
  2. (Optional) Call checkCustomer / updateCustomer to verify or update profile data.
  3. Use the same customer_id in decodeQr, getQuotation, and executePayout.
  4. getQuotation and executePayout enforce that tx_id belongs to the same customer_id.
SQRIL QR Scan to Pay

These are the sender fields currently required by the local providers to execute a payment transaction.

Sender Fields

This is a one-time call that will allow your customer to transact in any regions you integrated with.

Screen Shot 2026-04-23 at 4.50.48 PM

Sender Field Definition

Field nameData TypeDescription
name_firststringFirst name of the sender
name_laststringLast name of the sender
genderstringGender of the sender (M if male, F if female)
ic_numberstringID number of the ic_type
ic_typestringType of identity card
ic_countryString (ISO3166, country code)The country the identity card was issued in
occupationstringCode of the occupation of the sender.
country_of_residencestring (ISO3166, country code)Country of residence of the sender
phonestring (E.164 format)Phone number of the sender
emailstringEmail address of the sender
nationalitystring (ISO3166, country code)nationality of the sender
dobstring (ISO8601 (YYYY-MM-DD)Date of birth of the sender
addressstringComplete address
ic_expiry_datestring (ISO8601 (YYYY-MM-DD)The expiration date for the provided identification card or passport. For non-expiring credentials, please input 2099-01-01.

Occupation List

CodeDescription
OCC1C-Suite executive / Board membe
OCC2Employee
OCC3Entrepreneur / Business owner
OCC4Foreign worker
OCC5Foreign domestic worker
OCC6Home-maker
OCC7Middle management employee
OCC8Pilot
OCC9Professional
OCC10Senior management employee
OCC11Student

Identification Card List

CodeDescription
NICNational ID Card / Identity Card / Identification Card
PPPassport
WEPWork Permit / Employment Pass