DOCUMENTATION

Build with rostopay

One SDK for face checkout and online cash payment, hosted payment links for zero-code, and a clean REST API underneath. Sandbox faces and test banks included.

$ npm i @rostopay/checkout

Quickstart →

QUICKSTART

Create a session, mount the button

A session pins the amount, settlement mode and verification level. Mount the button anywhere; we open the camera, run liveness and matching, move the money, then redirect to your return_url with the transaction id.

✓

          
          
          
        
// 1 · server: create the session
const session = await rostopay.sessions.create({
amount: 4690, currency: 'usd',
settlement: 'instant', verify: 'face+liveness',
return_url: 'https://yourstore.com/thanks'
});
// 2 · client: mount the official button
rostopay.mount('#pay', { session: session.id });
// 3 · webhook
payment.settled → { tx_hash, sieve_id, amount, reg }

ZERO-CODE · PAYMENT LINKS

Every QR and link is just a URL

Dynamic charges, fixed Spot QRs, drive-thru screens and SMS links all resolve to the same hosted payment page — face checkout included, no integration needed.

{{ l.url }}

{{ l.title }} — {{ l.body }}

Params: amt cents · disc owner-governed cash discount (2% floor) · reg register id · ref free reference (e.g. valet ticket).

API REFERENCE

REST, versioned, predictable

Base URL api.rostopay.com/v1. Authenticate with your secret key; use sandbox keys to simulate faces, banks and every payment state — insufficient, declined, risk hold, large-amount cooling-off.

Webhooks: payment.settled · payment.pending · payment.failed · claim.opened · payout.reconciled — signed with your endpoint secret.

Every payment is provable by hash

sieve_id + tx_hash → verify.rostopay.com

Get API keys For merchants

Explore rostopay

Online cash payment, biometric checkout and pay-with-your-face resources.