Last updated
These docs are intended for a developer audience.Dismiss

Digital wallets

This topic describes how to set up the Apple Pay, Google Pay™, and Samsung Pay digital wallets for use in embedded payment forms. All other payment methods only require configuration on the payment gateway.

This configuration is not required for hosted payment forms. To configure Google Pay™ for hosted payment forms, see Set up a payment gateway.

Set up Google Pay™

This process describes how to set up Google Pay™ for use in embedded payment forms.

Complete the following steps:

  1. Create an embedded payment form. For more information, see Integrate embedded payment forms.

  2. Add Google Pay™ to a payment gateway as a payment method

    This process describes how to add Google Pay™ to a payment gateway that has already been set up in Rebilly. If you have not set up a payment gateway yet, see Set up a payment gateway. Ensure that the payment gateway supports the payment card payment method and Google Pay™. The following gateway accounts support digital wallets: Worldpay, CheckoutCom, Stripe, Safecharge, BlueSnap, NMI, and Adyen.

    If you are experimenting with the product in the sandbox environment, a test payment gateway called TestProcessor is configured for all Rebilly accounts.

    1. Log in or sign up to Rebilly.
    2. In the left navigation bar, press Settings .
    3. In the Configuration section, press Gateway accounts.
    4. In the list of gateways, select a gateway account.
    5. In the Payment methods section, in the Payment method dropdown, select Payment-card.
    6. In the Digital wallets section, select the Google Pay checkbox.
    7. In the Merchant name field, enter a merchant name to display on the payment sheet.
    8. In the Merchant origin field, enter the hostname of the merchant website where the checkout process is initiated.
    9. In the Country dropdown, select the country where the transaction is processed.
    10. Scroll to the top or bottom of the page and press Save gateway account.
  3. Test Google Pay™
    1. Open your embedded payment form in any browser.
    2. Press the Google Pay™ button.
    3. Follow the on-screen instructions to complete the payment.
      For test payment cards, see Google Pay™ - Test card suite.
    4. When the transaction is complete, View payment transaction details in Rebilly.

Interactive Google Pay™ checkout example

This is an interactive example of a basic checkout Google Pay™. It showcases all possible Google Pay™ button styles.

Set up Apple Pay

This process describes how to set up Apple Pay for use in embedded payment forms.

Set up Apple Pay in the sandbox environment

This process describes how to set up Apple Pay for use as a payment method in the Rebilly sandbox environment.

  1. Create an embedded payment form. For more information, see Integrate embedded payment forms.

  2. Register your domain for Apple Pay

    Register your domain using the Register a domain for Apple Pay API operation, or check if it is already registered. Once the domain is registered, you can use Apple Pay in embedded payment forms.

    Replace store.example.com with your own domain.

    curl --location --request POST 'https://api-sandbox.rebilly.com/digital-wallets/onboarding/apple-pay' \
    --header 'REB-APIKEY: {YOUR_API_KEY}' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "domain":"store.example.com"
    }'
  3. Add Apple Pay to a payment gateway as payment card digital wallet

    This process describes how to add Apple Pay to a payment gateway that has already been set up in Rebilly. If you have not set up a payment gateway yet, see Set up a payment gateway. Ensure that the payment gateway supports the payment card payment method and Apple Pay. The following gateway accounts support digital wallets: Worldpay, CheckoutCom, Stripe, Safecharge, BlueSnap, NMI, and Adyen.

    If you are experimenting with the product in the sandbox environment, a test payment gateway called TestProcessor is configured for all Rebilly accounts.

    1. Log in or sign up to Rebilly.
    2. In the left navigation bar, press Settings .
    3. In the Configuration section, press Gateway accounts.
    4. In the list of gateways, select a gateway account.
    5. In the Payment methods section, in the Payment method dropdown, select Payment-card.
    6. In the Digital wallets section, select the Apple Pay checkbox.
    7. In the Merchant name field, enter a merchant name to display on the payment sheet.
    8. In the Country dropdown, select the country where the transaction is processed.
    9. Scroll to the top or bottom of the page and press Save gateway account.
  4. Test Apple Pay
    1. Create an Apple sandbox tester account and add a test card to your wallet.

      You must use the Safari browser on an Apple computer to test Apple pay. Apple Pay is not supported on other browsers. When using an iOS device, Apple Pay should work in all browsers.

    2. Open your embedded payment form in Safari on an Apple device.

    3. Press the Apple Pay button.

    4. Follow the on-screen instructions to complete the payment.

    5. When the transaction is complete, View payment transaction details in Rebilly.

    For more detailed information on testing Apple Pay, see Apple Pay testing.

Set up Apple Pay in the live environment

This process describes how to set up Apple Pay for use as a payment method in the Rebilly live environment.

  1. Create an embedded payment form. For more information, see Integrate embedded payment forms.

  2. Register your domain for Apple Pay

    For the purposes of this example, store.example.com is used as a placeholder. Replace this with your own domain.

    1. In the live environment, host the Rebilly Apple Pay merchant domain verification files on your domain. For example, https://store.example.com/.well-known/apple-developer-merchantid-domain-association.
    2. Register the domain using the Register a domain for Apple Pay API operation, or check if it is already registered. Once the domain is registered, you can use Apple Pay in embedded payment forms.

    Example using a live API endpoint:

    curl --location --request POST 'https://api.rebilly.com/digital-wallets/onboarding/apple-pay' \
    --header 'REB-APIKEY: {YOUR_API_KEY}' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "domain":"store.example.com"
    }'
  3. Add Apple Pay to a payment gateway as a payment card digital wallet

    This process describes how to add Apple Pay to a payment gateway that has already been set up in Rebilly. If you have not set up a payment gateway yet, see Set up a payment gateway. Ensure that the payment gateway supports the payment card payment method and Apple Pay. The following gateway accounts support digital wallets: Worldpay, CheckoutCom, Stripe, Safecharge, BlueSnap, NMI, and Adyen.

    1. Log in or sign up to Rebilly.
    2. In the left navigation bar, press Settings .
    3. In the Configuration section, press Gateway accounts.
    4. In the list of gateways, select a gateway account.
    5. In the Payment methods section, in the Payment method dropdown, select Payment-card.
    6. In the Digital wallets section, select the Apple Pay checkbox.
    7. In the Merchant name field, enter a merchant name to display on the payment sheet.
    8. In the Country dropdown, select the country where the transaction is processed.
    9. Scroll to the top or bottom of the page and press Save gateway account.
  4. Test Apple Pay

    Use a live payment card to test Apple Pay.

    You must use the Safari browser on an Apple computer to test Apple pay. Apple Pay is not supported on other browsers. When using an iOS device, Apple Pay should work in all browsers.

    1. Open your embedded payment form in Safari on an Apple device.
    2. Press the Apple Pay button.
    3. Follow the on-screen instructions to complete the payment.
    4. When the transaction is complete, View payment transaction details in Rebilly.

    For more detailed information on testing Apple Pay, see Apple Pay testing.

Interactive Apple Pay checkout example

To interact with this example, you must use the Safari browser on an Apple device. Apple Pay is not supported on other browsers or devices.

Set up Samsung Pay

This process describes how to set up Samsung Pay for use in embedded payment forms.

Samsung Pay has limited support for devices and browsers. For more information, see the Samsung Pay Web Payments Integration Guide prerequisites.

Complete the following steps:

  1. Create an embedded payment form. For more information, see Integrate embedded payment forms.

  2. Register your domain with Samsung Pay

    To use Samsung Pay, you must register a domain, which is a manual process. Contact Rebilly for help with this process.

  3. Add Samsung Pay to a payment gateway as a payment method

    This process describes how to add Apple Pay to a payment gateway that has already been set up in Rebilly. If you have not set up a payment gateway yet, see Set up a payment gateway. Ensure that the payment gateway supports the payment card payment method and Samsung Pay. The following gateway accounts support digital wallets: Worldpay, CheckoutCom, Stripe, Safecharge, BlueSnap, NMI, and Adyen.

    If you are experimenting with the product in the sandbox environment, a test payment gateway called TestProcessor is configured for all Rebilly accounts.

    1. Log in or sign up to Rebilly.
    2. Select an environment: In the top right corner of the page, press your initials and then select Sandbox or Live environment.
    3. In the left navigation bar, press Settings .
    4. In the Configuration section, press Gateway accounts.
    5. In the list of gateways, select a gateway account.
    6. In the Payment methods section, in the Payment method dropdown, select Payment-card.
    7. In the Digital wallets section, select the Samsung Pay checkbox.
    8. In the Merchant name field, enter a merchant name to display on the payment sheet.
    9. Scroll to the top or bottom of the page and press Save gateway account.

Interactive Samsung Pay checkout example

To interact with this example, you must open this webpage in a Samsung mobile device.