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
Api Key
8e65ed69-d84e-4ddd-82a9-031de6181869
Api Secret
klarna_test_api_dUZoaVVIYkticTB2LWhhd0QyMUhBbDIzU2ExIVg5d1EsOGU2NWVkNjktZDg0ZS00ZGRkLTgyYTktMDMxZGU2MTgxODY5LDEsQitidkE1SnJzckZuUXZIUDZJM1pXQTFKTmZZSzJnTGVBMW1rbTY4aUcyaz0
