Payment Service

Overview

The Payment service allows transactions to be performed with both real and virtual currency, and integrates with Adyen, Xsolla, Stripe, PayPal, AliPay, WxPay, and wallet services. The payment service provides a retry mechanism that prevents notifications from failing to appear during the payment process. This retry mechanism will resend failed notifications until the client acknowledges their receipt, or the maximum number of retries has been reached.

The Payment service includes several features to support the payment process, including:

  • Real and virtual currency One payment service can cover both real currency purchases of games or add-ons, or in-game purchases of items or boosters using AccelByte coins.
  • Support for multiple payment providers Our Payment service can integrate with Adyen Xsolla, and Stripe payment aggregators, and can accept payments from PayPal, Visa, Mastercard, AliPay, and WxPay.
  • Payment account management Our Admin Portal allows you to manage what types of payments you accept and configure your payment aggregators.
  • Customized payment station You can change the look of your payment station to highlight your brand.
  • Email notifications for paid orders Players receive email verification of successful transactions.

Tutorials

Contact us for instructions on how to integrate third party payment aggregators.

Setting Up Adyen as a Payment Aggregator in Admin Portal

  1. In the Admin Portal, go to the Payment Configurations menu under the Platform Configurations dropdown on the top-right header.

    payment

  2. Add a new configuration by clicking the New Configuration button.

    payment

  3. Fill in the required fields.

    payment

    • Select the Namespace for the payment configuration. You can select all namespaces if desired.
    • Select the Region for the payment configuration. You can select all regions if desired.
    • Select Adyen from the Payment Aggregator dropdown list.
    • You can leave the Payment Methods field empty.

When you’re done, click the Submit button and you will be redirected to the Payment Configuration page.

  1. In your newly created payment configurations, go to the Payment Aggregator section and click the Configure now button.

    payment

  2. Fill in the required fields.

    payment

    • Input the API Key from Adyen.
    • Input the Adyen Merchant Account.
    • Input the Notification Hmac Key.
    • Input the Notification Username and Password.
    • Input the Live Endpoint URL Prefix.
    • Input the Return URL.
    • Choose if you want to enable Authorize as Capture.

When you’re done, click Add and your config will be saved.

Setting Up Xsolla as a Payment Configuration in the Admin Portal

  1. In the Admin Portal, go to the Payment Configurations menu under the Platform Configurations dropdown on the top-right header.

    payment

  2. Add a new configuration by clicking the New Configuration button.

    payment

  3. Fill in the required information.

    payment

    • Select the Namespace for the payment configuration. You can select all namespaces if desired.
    • Select the Region for the payment configuration. You can select all regions if desired.
    • Select Xsolla from the Payment Aggregator dropdown list.
    • You can leave the Payment Methods field empty.
  4. Click Submit to continue. You will be redirected to the Payment Configuration page.

  5. In the Payment Aggregator section, under the Xsolla tab, fill in the required information.

  6. Click the Test button, and make sure you get Xsolla Configured Correctly notification.

Setting Up Stripe as a Payment Configuration in the Admin Portal

  1. In the Admin Portal, go to the Platform Configurations dropdown and choose Payment Configurations.

    payment

  2. Click the New Configuration button to add a new configuration.

    payment

  3. Fill in the required fields.

    • Select the Namespace for the payment configuration. You can select all namespaces if desired.
    • Select the Region for the payment configuration. You can select all regions if desired.
    • Select Stripe from the Payment Aggregator dropdown list.
    • You can leave the Payment Methods field empty.

    payment

    When you’re done, click the Submit button and you will be redirected to the Payment Configuration page.

  4. In the Payment Aggregator section, click Configure Now.

    payment

  5. Fill in the required fields.

    • Input the Publishable Key field with the key you received from the Stripe dashboard.
    • Input the Secret Key field with the key you received from the Stripe dashboard.
    • Input the Webhook Secret field with the secret you received from the Stripe dashboard.

    payment

  6. Click the Test button and make sure you receive a notification that Stripe has been configured correctly.

Setting Up Checkout.com as a Payment Aggregator in the Admin Portal

  1. In the Admin Portal, go to the Payment Configurations menu under the Platform Configurations dropdown on the top-right header.

    payment

  2. Add a new configuration by clicking the New Configuration button.

    payment

  3. In the Payment Aggregator section, click the Configure Now button.

    payment

  4. A configuration form appears. Fill in the required information.

    • Input the Public Key from checkout.com.
    • Input the Secret Key from checkout.com.

    payment

    After configuring the Payment Configuration, you’ll be directed to the Payment Configuration Details.

    payment

Managing Your Payment Methods

After you’ve configured your payment aggregator, you can also configure the payment methods you support.

  1. In the Admin Portal, go to Payment Configurations Details and scroll down to the Payment Methods panel.

    payment

  2. In the Payment Methods, choose your payment method and input the required information.

    a. For AliPay:

    • Input the App ID from the AliPay platform.
    • Input the Private Key.
    • Input the Public Key.
    • Input the Return URL.

    b. For AliPay Sandbox:

    • Input the App ID from the AliPay Sandbox platform.
    • Input the Private Key.
    • Input the Return URL.
    • Input the Public Key.

    c. For WxPay:

    • Input the App ID from the WxPay platform.
    • Input the Key.
    • Input the MCHID.
    • Input the Return URL.
    • Upload the Certificate AWS Path by clicking the Upload button and searching for the file on your computer.

    After you’ve filled in the correct form, click the Test button to test the payment configuration.

What’s Next?

  • For more information about the Payment service, check out the API Reference.
  • Take a look at our Fulfillment service.
  • Learn about how to set up Currency on our platform.