Skip to main content
Waffo provides the frontend SDK @waffo/payment-sdk, which supports directly integrating payment and card binding capabilities into merchant pages.

Installation

Initialization

Feature overview

FeatureMethodDescription
Card tokenizationsdk.tokenizationSubmit()Securely submits card information and generates a token
Embedded checkoutWaffoSDK.renderIframe()Embeds the Waffo checkout as an iframe in the merchant page

Card tokenization (tokenizationSubmit)

Encrypts and submits the user’s card information to Waffo. The merchant server never touches the plaintext card number.

Prerequisites

The merchant backend must first call the Generate API to obtain a tokenSessionId.

Submit card

Handle result

For the complete flow, see Card binding and token management.

Embedded checkout (renderIframe)

Embeds the Waffo checkout as an iframe in the merchant page. Suitable for merchants who do not want to build their own checkout UI.
Supports:
  • Custom theme colors
  • Custom logo
  • Apple Pay / Google Pay buttons
  • Multiple languages

Checkout appearance customization

The checkout appearance theme (cashierAppearance), language (cashierLanguage), and payment method filtering are configured through the order-creation paymentInfo parameter. For the full value ranges, format, and examples, see Checkout customization.