Merchant Payment Method Configuration

Payment Method Configuration

Once a merchant has been onboarded, the next step is to configure their payment methods. This process involves two distinct API calls: one to discover available payment methods and their required credential structure, and a second to activate the chosen method.

Step 1: Discover Available Payment Methods

To begin, you must call the /merchant/provider/new endpoint. This API call returns a list of all available payment methods that can be configured for the merchant. Crucially, the response from this endpoint also provides the specific structure of the credentials required (credentialsFields) for each payment method. This information is essential for the next step. It can also be used to display and collect the relevant fields from your merchant.

• credentialsFields

  • name: The name of the field that should be passed in the credentials fields when enabling that payment method

  • infoGuide: A guide decribing the credential and where to get it in the payment providers portal

Step 2: Activate a Payment Method

After identifying the desired payment method, you will use the /merchant/provider/activate/new endpoint to activate it. In this call, you must pass the merchant's unique ID and the credentials for the chosen payment method. The credentials must be formatted exactly as outlined in the response from the previous /merchant/provider/new API call. Upon a successful call, the payment method will be enabled and ready for use by the merchant.

For basic testing purpose it is recommened to not specify a channel, if you wish to explore this functionality please look into the channels section on the merchant documentation.

The credentials used for enabling this method should be obtained directly from the merchants (or MoR) relationship with the payment method.

For testing purposes you can use the credentials below to enable a payment method and test putting through an order.

Credentials

Klarna AUD

Api Key 8e65ed69-d84e-4ddd-82a9-031de6181869

Api Secret klarna_test_api_dUZoaVVIYkticTB2LWhhd0QyMUhBbDIzU2ExIVg5d1EsOGU2NWVkNjktZDg0ZS00ZGRkLTgyYTktMDMxZGU2MTgxODY5LDEsQitidkE1SnJzckZuUXZIUDZJM1pXQTFKTmZZSzJnTGVBMW1rbTY4aUcyaz0

Go Cardless USD

Volt AUD

FatZebra 3DS

Test Data

Klarna AUD

Phone Number: [phone]

Go Cardless USD

Volt AUD

FatZebra 3DS