29 NEXT
  • Welcome to 29 Next Docs
  • About 29 Next
  • Changelog
  • Start Here
    • 🌟Get Started on 29 Next
      • General Settings & Branding
      • Link Domains
      • Invite Team Members
      • Add Locations & Languages
      • Checkout Settings & Policies
      • Customer Storefront Accounts
      • Fulfillment Settings
      • Support & Notifications
      • Add Payment Providers
    • ⚡Developer Docs
  • BUILD A STORE
    • 📦Products Catalogue
      • Add Products
      • Inventory
      • Product Variants
      • Gift Cards
      • Upsells & SEO Settings
      • Create Categories
      • Google Merchant XML Feed
      • Tax Settings
    • 🛒Storefront
      • Customer Accounts
      • Support Content
      • Custom Pages
      • Blogs
      • Storefront Redirects
    • 🪄Technical Settings
      • Metadata Fields & Tags
      • Configure Webhooks
      • Storefront API & Events
  • Manage Orders
    • 📥Orders
      • Create Orders
      • Order Management
      • Edit Orders
      • Refund Items & Orders
      • Create & Manage Returns
      • Order Statuses
      • Open Carts
      • Test Orders
    • 👥Customers Guide
      • Customer Carts
      • Checkout Links
    • 🔃Subscriptions Guide
      • Subscription Settings
      • Managing Subscriptions
      • Account Updater
      • Decline Salvage
      • Subscription Statuses
    • 📞Support Guide
  • Features
    • 🛍️Offers Guide
      • Create and Manage Offers
      • Product Ranges
      • Coupons
      • Shareable Coupon Links
      • Marketing Attribution
    • 💳Payments Guide
      • 3DS2 Payments
      • PayPal
      • Apple Pay
      • Google Pay
      • Stripe APMs
      • Authorize & Capture Payments
      • Disputes Guide
      • Block Lists
      • Payment Failure Cascading
      • Transaction Response Codes
    • 🚚Fulfillment Guide
      • Fulfillment Statuses
      • Location-Based Routing
      • Advanced Settings
  • Apps
    • 3PL Central
    • Avalara AvaTax
    • Campaigns App
    • Delivery Tracking
    • Everflow
    • Meta Pixel
    • Gorgias
    • Klaviyo
    • MaxMind minFraud
    • Chargeback360
    • TaxJar
    • ShipStation
    • Shop Sync
  • Analytics
    • Dashboards
    • Orders Reports
    • Customers Reports
    • Disputes Reports
    • Gift Card Reports
    • Fulfillment Reports
    • Transactions Reports
    • Support Ticket Reports
    • Subscription Reports
    • Tax Reports
    • Partner Marketing Reports
Powered by GitBook
On this page
  • Payment Gateways
  • Adding a 29 Next Payments Account
  • Adding a Payment Gateway
  • Gateway Groups
  • Payment Transactions
  • Transactions List View
  • Transactions Detail View

Was this helpful?

  1. Features

Payments Guide

Set up and manage Gateways, Payment Apps, and more

PreviousMarketing AttributionNext3DS2 Payments

Last updated 1 year ago

Was this helpful?

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.

29 Next Payments

Adyen

Airwallex*

Stripe Payment Intents

Braintree

Checkout.com

Authorize.net

NMI

Nuvei

BlueSnap

Paypal Commerce Platform

WorldPay

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

Adding a 29 Next Payments Account

To add 29 Next Payments to your store, from your 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

  • A Name for the gateway, referenced in Reports

  • Currencies Supported - leave blank to accept all currencies

  • Accepted Card Types - leave blank to accept all card types

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

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

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.

For aggregated reports on Payments transactions, see Transaction Reports:

Payment Flow (Charge, or )

Optionally - Enable 3DS2 support, and assign a to the gateway

Optionally - Enable Cascading

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 .

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

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

To manually 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 transaction list.

💳
Authorize & Capture
Declined Initial Charge Attempts
Admin API
Marketing Source Attribution
PayPal's
Transactions Reports
29 Next Account
Capture an Authorized transaction
3DS2 Merchant Profile
3DS Merchant Profile
Disputed