CardWallet API Methods

API/cardWallet/session

This endpoint initiates a new payment using the Card Wallet flow and retrieves merchant session data.

  • Sends a payment request with all relevant payment information to the payment gateway so the payment can be registered for later authorization.
  • Includes any additional data required by the wallet provider to retrieve a session used to proceed with the payment (for example, for Apple Pay the validationUrl is appended).
  • The returned session object must be passed to session.completeMerchantValidation(JSON.parse(merchantSession)); to enable payment authorization.
  • This step is optional. When using the iOS Mobile SDK, the session is validated directly on the device, and no gateway interaction is involved.

API/cardWallet/authorize

This step finalizes the Card Wallet payment by authorizing the previously registered payment. If no payment has been registered, all relevant payment information must be provided at this step, to process this action.

By invoking this method, the gateway decrypts provided session data using the Processing Key and authorizes the transaction against the selected acquirer.

Returned response is similar to callback xml.

Task

Method

Initialize credit card wallet session.

session

Authorize credit card wallet session.

authorize