Optional quick payment
Pay from balance.Still one payment.
Paybytoken Pay lets an eligible returning customer approve one exact stablecoin purchase from their Paybytoken balance. The merchant still integrates the normal PaymentIntent lifecycle.
Acme Supply
Order #1048
Amount to approve
10.15 USDC
No wallet signature and no new on-chain transfer at checkout.
Hosted customer journey
Run the real test flow.
- 01
Link account
Authenticate directly with Paybytoken and approve the merchant link.
- 02
Approve order
Review merchant, exact asset, amount, and balance on Paybytoken.
- 03
Verify payment
Fulfil only from the canonical PaymentIntent or signed webhook.
Start with consumer consent
The hosted Paybytoken page handles sign-in, enrollment, and one-time merchant linking. Consumer credentials never enter this merchant page.
Merchant contract
Link once. Authorize every order.
Paybytoken Pay shortens the returning-customer experience without creating a parallel order system. Every purchase remains a new PaymentIntent with its own consumer approval and canonical result.
- 01Link once
POST /api/v1/consumer_link_sessionsStore the approved merchant Customer relationship; never expose the merchant key.
- 02Every order
POST /api/v1/payment_intentsCreate a new immutable intent with payment_method_types: ["paybytoken_pay"].
- 03Consumer action
POST /api/v1/consumer_payment_sessionsRedirect to short-lived Paybytoken-hosted review and authorization.
- 04Fulfil once
payment_intent.succeededVerify the signed webhook or retrieve the intent from the merchant server.
Browser return means “continue reconciliation,” never “ship the order.”
event.data.object.id → pay_…