Cards and Digital Wallets: Accepted Payment Methods

Card payments and digital wallets both use the same POST /payment/purchase endpoint, with a single discriminated paymentMethod object: { "type": "<code>", "<code>": { ...fields } }. paymentMethod is always required and explicit — there is no implicit default, "card" included. All card and wallet methods support both one-time and recurring (subscription) charges unless noted otherwise.

Wallet methods such as Apple Pay and Google Pay require a connection configured in your Therius dashboard. Contact Therius to enable wallet decryption for your merchant account before going live.

Credit/Debit Card — `card`

Cards are the universal default. Every currency and country is supported. Pass raw card data server-side during testing; for browser-based checkouts, use a nonce from the JS SDK’s hosted fields instead of raw card data to keep your integration out of PCI scope.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 4999, "exponent": 2 },
  "paymentMethod": {
    "type": "card",
    "card": {
      "cardData": {
        "cardNumber": "4111111111111111",
        "cardholderName": "Ada Lovelace",
        "expiryMonth": "12",
        "expiryYear": "2030",
        "cvv": "123"
      }
    }
  }
}

card also accepts nonceData (an SDK hosted-fields nonce), tokenData (reuse a vaulted card), networkTokenData, installments, cardOnFile, networkTransactionId, networkReferenceId, and threeDs (pre-authenticated 3DS proof from your own MPI — see 3D Secure) — all inside the same card object, never at the request root.

Apple Pay — `applepay`

Apple Pay is supported across iOS, macOS, and Safari. Use the JS SDK’s createWalletButton to render the Apple Pay button and launch the payment sheet. The raw payment token returned by ApplePaySession goes into applepay.token. Apple Pay supports recurring charges.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "applepay",
    "applepay": {
      "token": "<base64 token from ApplePaySession>"
    }
  }
}

Google Pay — `googlepay`

Google Pay works across Android, Chrome, and any browser where the shopper has a saved card. Use the JS SDK’s createWalletButton to render the button and receive the PaymentData token. Google Pay supports recurring charges.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "googlepay",
    "googlepay": {
      "token": "<token from Google PaymentData>"
    }
  }
}

Click to Pay — `click_to_pay`

Click to Pay is the Visa/Mastercard network-level saved-card scheme, powered by CyberSource. The shopper selects a saved network card without entering card details. Use the JS SDK’s createClickToPayButton to render the button and obtain a nonce.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "click_to_pay",
    "click_to_pay": {
      "encPaymentData": "<encrypted payload from createClickToPayButton>",
      "callId": "<call ID from createClickToPayButton>"
    }
  }
}

For the Adyen Card Component’s Click to Pay flow instead, pass adyenPaymentMethod (the component’s onSubmit state) in place of encPaymentData/callId — Therius forwards it to Adyen verbatim without decrypting it.

The redirect wallets below (PayPal through PicPay) have no provider-required fields beyond type — they’re pure redirects. Omit paymentMethod and the request is rejected — every method must be sent explicitly.

PayPal — `paypal`

PayPal supports USD, EUR, GBP, and many additional currencies. It is a redirect-based flow — the shopper is redirected to PayPal to log in and confirm. The response returns status: "pending_action" with actionRequired.url.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "paypal",
    "paypal": {}
  }
}

Venmo — `venmo`

Venmo is available for USD transactions in the United States. It uses a redirect flow similar to PayPal.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "venmo",
    "venmo": {}
  }
}

Alipay — `alipay`

Alipay supports CNY plus 13 additional currencies for cross-border transactions. Shoppers authenticate in the Alipay app or via QR code. The response returns a redirect URL or QR payload.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "CNY", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "alipay",
    "alipay": {}
  }
}

WeChat Pay — `wechat_pay`

WeChat Pay supports CNY plus 9 additional currencies. Shoppers scan a QR code or complete payment inside the WeChat app.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "CNY", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "wechat_pay",
    "wechat_pay": {}
  }
}

GrabPay — `grabpay`

GrabPay is Southeast Asia’s leading super-app wallet, available in Malaysia, Singapore, Philippines, Thailand, and Vietnam. Supported currencies: MYR, SGD, PHP, THB, VND.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "SGD", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "grabpay",
    "grabpay": {}
  }
}

Amazon Pay — `amazon_pay`

Amazon Pay lets shoppers use their Amazon account’s stored payment and address details. Supported currencies: USD, EUR, GBP, JPY.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "amazon_pay",
    "amazon_pay": {}
  }
}

Revolut Pay — `revolut_pay`

Revolut Pay is available for EUR, GBP, and Central & Eastern European currencies. Shoppers authenticate via the Revolut app.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "EUR", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "revolut_pay",
    "revolut_pay": {}
  }
}

TWINT — `twint`

TWINT is Switzerland’s national mobile payment app. CHF only.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "CHF", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "twint",
    "twint": {}
  }
}

MobilePay — `mobilepay`

MobilePay is widely used in Denmark and Finland. Supported currencies: DKK, EUR.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "DKK", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "mobilepay",
    "mobilepay": {}
  }
}

Cash App Pay — `cashapp`

Cash App Pay is available for USD transactions in the United States. Shoppers authenticate via the Cash App on their mobile device.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "cashapp",
    "cashapp": {}
  }
}

PicPay — `picpay_wallet`

PicPay is a popular Brazilian digital wallet. BRL only.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "BRL", "value": 5000, "exponent": 2 },
  "paymentMethod": {
    "type": "picpay_wallet",
    "picpay_wallet": {}
  }
}

Wallet Tokenization

You can save a wallet payment method for future use — for example, to charge a shopper again without requiring them to re-authenticate. To tokenize a wallet transaction, set tokenize: true inside the wallet’s object and include a shopper.id in your request. Therius stores the wallet token against that shopper and makes it available for subsequent charges.

{
  "merchantCode": "MERCHANT_001",
  "orderCode": "ORDER-001",
  "amount": { "currency": "USD", "value": 5000, "exponent": 2 },
  "shopper": {
    "id": "SHOPPER-001"
  },
  "paymentMethod": {
    "type": "applepay",
    "applepay": {
      "token": "<base64 token from ApplePaySession>",
      "tokenize": true
    }
  }
}

Wallet tokenization requires a shopper.id. Without it, the tokenize flag is ignored and no token is saved.

Get Started

Core Concepts

Guides

Webhooks

AI Assistant

E-Commerce Plugins

Cards and Digital Wallets: Accepted Payment Methods

Credit/Debit Card — `card`

Apple Pay — `applepay`

Google Pay — `googlepay`

Click to Pay — `click_to_pay`

PayPal — `paypal`

Venmo — `venmo`

Alipay — `alipay`

WeChat Pay — `wechat_pay`

GrabPay — `grabpay`

Amazon Pay — `amazon_pay`

Revolut Pay — `revolut_pay`

TWINT — `twint`

MobilePay — `mobilepay`

Cash App Pay — `cashapp`

PicPay — `picpay_wallet`

Wallet Tokenization

​Credit/Debit Card — card

​Apple Pay — applepay

​Google Pay — googlepay

​Click to Pay — click_to_pay

​PayPal — paypal

​Venmo — venmo

​Alipay — alipay

​WeChat Pay — wechat_pay

​GrabPay — grabpay

​Amazon Pay — amazon_pay

​Revolut Pay — revolut_pay

​TWINT — twint

​MobilePay — mobilepay

​Cash App Pay — cashapp

​PicPay — picpay_wallet

​Wallet Tokenization

Credit/Debit Card — `card`

Apple Pay — `applepay`

Google Pay — `googlepay`

Click to Pay — `click_to_pay`

PayPal — `paypal`

Venmo — `venmo`

Alipay — `alipay`

WeChat Pay — `wechat_pay`

GrabPay — `grabpay`

Amazon Pay — `amazon_pay`

Revolut Pay — `revolut_pay`

TWINT — `twint`

MobilePay — `mobilepay`

Cash App Pay — `cashapp`

PicPay — `picpay_wallet`

Wallet Tokenization