Adyen
Prerequisites
Before you begin, you need to have a Adyen account. Make sure you have a Adyen API key and secret, with the least amount of permissions required to access the functionality of the Adyen Connector you plan to use.
Make sure to create an API key dedicated to Formance. Doing so will improve your auditability and security and will allow you to revoke access to Formance at any time if needed.
In order to use the adyen connector, you will have to create a webhook in your Adyen account. You need to go to Developers > Webhooks in your Adyen account and click on the button to add a new standard webhook.
Then, on the webhook creation page, you need to first generate a new HMAC key.
Copy the HMAC key and paste it in the hmacKey
field in the JSON configuration
for the formance connector. You can now create the connector on the Formance
platform using the following command:
Installation
- fctl
- curl
fctl payments connectors install adyen config.json
curl -X POST "https://$STACK.formance.cloud/api/payments/connectors/adyen" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d @config.json
With config.json containing:
Retrieve the connector ID after creation, you will need it to link the connector to the webhook in Adyen.
Finally, you can add the URL in the server configuration in the webhook creation page on Adyen. The URL must have the following format:
https://$STACK.formance.cloud/api/payments/connectors/webhooks/adyen/<connectorID>/
You can now save the configuration and wait for webhooks to start coming in.