1. Alternative Payment Methods
Sipay API Documentation - ZA
  • Overview
    • Getting Started
    • Test Cards
  • Authentication
    • Token Generation
      POST
  • Commission
    • Commission
      POST
  • HASH
    • Hash Creation
    • Hash Validation
  • Non-Secure Payment
    • Non-Secure Payment Flow
    • Non-Secure Card Payment
      POST
    • Non-Secure Pre-Authorization Payment
      POST
    • Confirm Payment
      POST
  • 3D Secure Payment
    • 3D Secure Payment Flow
    • 3D Secure Card Payment
      POST
    • 3D Secure Pre-Authorization Payment
      POST
    • Complete Payment
      POST
    • Confirm Payment
      POST
  • Non-Secure and 3D Payment with Sipay
    • Non-Secure and 3D Secure Payment with Sipay
  • Check Status
    • Check Status
  • Refund
    • Refund
  • Webhook
    • Webhook
  • Status Codes
    • Status Codes
  • Alternative Payment Methods
    • Overview
    • Payment Flow
    • Base URL & Environments
    • Hash Key
    • Client-side SDK handling
    • Status Codes
    • End-to-end example
    • GPay Payment Example
    • Authentication
      POST
    • walletCheckout
      POST
    • walletPay
      POST
  1. Alternative Payment Methods

Payment Flow

The payment flow is shown below:
1.
Get a bearer token — call /token with your app_id / app_secret.
2.
Call walletCheckout from your server with the order amount, currency, invoice_id and the wallet(s) you want to offer. Returns JavaScript.
3.
Inject the returned script into checkout page and provide a container element with id="walletCheckout". The script loads the wallet provider SDK and renders the wallet button.
4.
Customer taps the wallet button and authenticates (Face ID / fingerprint / device PIN). The SDK emits a transient token (a short-lived JWT) via the sipay:wallet-token event or your window.sipayWalletTokenHandler callback.
5.
Send the transient token to your server, then call walletPay (server-to-server) with the same invoice_id and the cybersource_transient_token.
6.
Receive the final JSON result — status_code: 100 on success, with the sale details and commission breakdown.


Modified at 2026-06-02 14:16:20
Previous
Overview
Next
Base URL & Environments
Built with