Integrating Adyen
JustOn Cash Management can integrate with Adyen as a payment provider. It uses the Adyen's pre-built checkout solution for websites, Web Drop-in, to implement the payment procedure in the payment page, as well as notification webhooks to receive payment status updates.
Setting up Adyen as a payment provider involves the following tasks:
Creating Adyen Account
In order to use Adyen as a payment provider, you need a valid Adyen account. To get going, refer to Adyen's Get started guidelines.
To integrate with JustOn Cash Management, your Adyen account requires
- a dedicated merchant account
- a dedicated API credential
- notification webhooks
Configuring Merchant Account
To configure a dedicated merchant account (see Merchant accounts):
-
Request a new merchant account.
- In the Adyen Customer Area, proceed to Settings > Merchant accounts, and click Request new merchant account.
-
In the field
Desired account code
, specify a name for the merchant account.You need this name for the integration configuration in JustOn Cash Management.
-
In the field
Channel
, select to use the account for processing ecommerce transactions. - Click Submit.
For details, see Request a new merchant account.
-
Enable the automatic capture.
- In your merchant account, navigate to Settings > Account settings > General.
- In the
Capture delay
field, selectimmediate
.
For details, see Delayed automatic capture.
-
Enable the intended payment methods.
- In your merchant account, navigate to Settings > Payment methods > Request payment methods.
- Start typing the name of the intended payment method, then select it from the produced list.
- Click Submit.
For details, see Add payment methods to your account.
Configuring API Credential
To set up a dedicated API credential for JustOn Cash Management:
-
Create an API credential of the type
Web service user
.In the Adyen Customer Area, proceed to Developers > API credentials > Create new credential. For details, see Create an API credential.
-
Generate an API key and save it for the Adyen configuration in JustOn Cash Management.
In the Adyen Customer Area, proceed to Developers > API credentials > Credentials > Server settings > Authentication > API key > Generate API key. For details, see Generate an API key.
Make sure to copy your API key and to save it for the integration configuration in JustOn Cash Management.
-
Generate a client key and save it for the Adyen configuration in JustOn Cash Management.
In the Adyen Customer Area, proceed to Developers > API credentials > Credentials > Client settings > Authentication > Client key > Generate client key. For details, see Get your client key.
Make sure to copy your client key and to save it for the integration configuration in JustOn Cash Management.
-
Add the JustOn Cash Management payment page as an allowed origin.
In the Adyen Customer Area, proceed to Developers > API credentials > Credentials > Allowed origins. Specify
https://payment.juston.cloud
and click Add. For details, see Manage allowed origins.
Enabling Notification Webhooks
To enable notification webhooks for JustOn Cash Management:
-
Add a webhook of the type
Standard notification
.In the Adyen Customer Area, proceed to Developers > Webhooks > + Webhook. For details, see Set up notifications in your Customer Area.
-
Add the JustOn Cash Management webhook server URL.
Navigate to Server configuration and specify
https://payment.juston.cloud/webhooks/payment/payment-provider/adyen/:tenant/
where
:tenant
is the URI alias of your organization. -
Generate an HMAC key and save it for the Adyen configuration in JustOn Cash Management.
Navigate to Security > HMAC Key > Generate. For details, see Enable HMAC signatures.
Make sure to copy your HMAC key and to save it for the integration configuration in JustOn Cash Management.
Configuring Adyen Integration
To configure the Adyen integration with JustOn Cash Management:
-
Create a payment provider configuration record as necessary.
Make sure to select
Adyen
in theType
field.For details, see Creating Payment Provider.
-
Open the relevant payment provider record.
-
Click Edit Provider Data.
This launches a screen flow that shows the provider-relevant input fields (based on the
Type
field of the payment provider record).-
Modify the standard information as necessary.
Field Description Name The name for this configuration record. Business Entity The business entity for which this PSP configuration is applicable. Type The payment service provider for which this configuration is applicable. Active Enables/disables the PSP for payment users. -
Modify the Adyen-specific public information as necessary.
The public information required for Adyen includes:
Field Description Environment The region-specific part of the Adyen API URL, part of the configuration sent to the Web Drop-in. The available values include test
,live
,live-apse
,live-au
,live-us
.
Find your endpoint URLs in the Adyen Customer Area under Developers > API URLs > API URLs and Response.
For details, see Live endpoints structure.API Prefix The API prefix used with calls to the Adyen API.
This field is only visible if the environment is nottest
orNone
. Find your prefix in the Adyen Customer Area under Developers > API URLs > Prefix.
For details, see Live URL prefix.Merchant Account The name of your merchant account, sent to Adyen with every request.
Creating a merchant account is part of the Adyen account setup.Client Key The client key used by the Web Drop-in to authenticate requests from your JustOn Cash Management instance.
Generating the client key is part of the Adyen account setup.Capture Immediately Makes JustOn Cash Management treat each AUTHORIZATION
notification webhook as aCAPTURE
notification webhook. Selected by default.
Corresponds to the automatic capture setting in your merchant account (see Adyen account setup). -
Modify the Adyen-specific secret information as necessary.
The secret information required for Adyen includes:
Field Description API Key The key to authenticate requests to the Adyen API from your JustOn Cash Management instance.
Generating the API key is part of the Adyen account setup.HMAC Key The key used to verify webhook messages.
Generating the HMAC key is part of the Adyen account setup.The dialog does not disclose existing secret data.
-
-
Click Save.
This completes the screen flow, saving the specified information as required, and returns you to Payment Provider detail view.
Once the Adyen-specific data is complete, the Adyen configuration is fully functional and available to payment users.