💳Payments Guide

Set up and manage Gateways, Payment Apps, and more

Payment Gateways

29 Next supports 120+ global gateways for bankcard transactions, encompassing credit and debit cards such as Visa, Mastercard, AMEX, Discover, Maestro, JCB and more. If you don’t see your payment gateway listed as supported, just ask us.

*Airwallex accounts require 3DS2 by default. You must make a request to support to remove this restriction to bypass 3DS2, or set up a 3DS2 Merchant Profile to assign to the gateway.

Adding a 29 Next Payments Account

To add 29 Next Payments to your store, from your 29 Next Account choose Payments, then choose Create New.

You will be redirected to the onboarding flow to provide account setup details. Once an account is approved it will automatically be loaded into your store's Payment Gateways, and available for live transactions.

Adding a Payment Gateway

To add a Gateway, navigate to Settings > Payments to see a list of all gateways. Select Add Gateway to link a new gateway to your store.

Next, select the desired gateway integration and add your gateway specific access credentials. Note that the required fields for specific gateway integrations may vary.

Once a Gateway has been added to your store, you can specify

For orders created via the Admin API, you may optionally define a payment_gateway ID to route the transaction to a specific gateway ID via the payment_details > payment_gateway parameter.

Gateway Groups

Stores with multiple bankcard gateways may wish to distribute transactions across them on a proportional basis. With Gateway Groups, you can assign multiple gateways to a single group, and define a weighting to each gateway, to prioritize the distribution of transactions.

The Default Gateway Group is automatically used for storefront checkouts, or for API-created orders, unless a specific Gateway Group or a single Gateway is specified when creating the order.

To create or edit a Gateway Group, navigate to Settings > Payments and choose a Add Gateway Group from the Gateway Groups card. From this view you can also Update or Delete existing groups.

On the create gateway group page, assign one or more existing gateways to the group, and choose a weight for the proportion of transactions that should be directed to each of them, with the higher weights receiving the higher proportion of volume.

Transactions pointed at a gateway group will select from the gateways, based first on the availability for the given card type and currency, then on the weighting assigned to the eligible gateways. This rule prevents a gateway that does not support a given card type or currency from being selected to process a transaction.

For orders created via the Admin API, you may pass a payment_gateway_group ID in the payment_details > payment_gateway_group parameter. If a payment gateway group ID is specified, it will override the default gateway, or any value input into the payment_gateway field.

Gateway Groups with 3DS2 Payments over the API

If your payment flow includes gateways supporting 3DS2, you should always specify a payment_complete_url in your API request. Read more about supporting 3DS2 transactions over the Admin API.

Payment Transactions

Transactions List View

View the list of all payment transactions by navigating to the Payments menu. From this view you can filter and export lists of transactions to CSV by selecting Actions > Export to CSV.

Search & Filter Transactions

Transactions can be searched by using the Advanced Search feature. Choose Filters to transactions list by one or more of the following parameters:

  • Transaction ID

  • Date Range (From / To)

  • Type (Authorize/Debit/Refund/Void)

  • Subscription Lifecycle

  • Card BIN (card first 6 digits)

  • Card Last 4

  • Gateway Group

  • Amount of Transaction (From / To)

  • Currency

  • Response Code

  • Status

  • Is Disputed (Yes / No)

  • Is External

  • Is Test Transaction

  • Is Initial Retry

  • Initiators (Users)

  • Funnels

  • Agents

  • Is 3DS (yes/no)

  • Optimized 3DS

  • 3DS Downgrade Retry

  • SCA Flow

Additionally, filter the transactions list by any Marketing Source Attribution values that are connected to the Order on which a transaction was made.

Transactions Detail View

Clicking on any Transaction ID, or the View button from the Transactions List View will show the Transaction Detail. Transaction details provide all information available for the transaction, including the raw transaction data sent to the payment provider or gateway, and the data returned in response.

Choose Actions from this view to apply a Refund (or Void) to a transaction, or to mark a transaction as Disputed.

To manually Capture an Authorized transaction within the authorization period, choose Actions > Capture Payment.

Non-bankcard transactions appear in the Transactions List view, but viewing the transactions details will link to the underlying Payment App view, for example PayPal's transaction list.

For aggregated reports on Payments transactions, see Transaction Reports:

Last updated