Corefy (V2)

Unify the payment world

Website: corefy.com

Set Up Account & Create Merchant

1. Before you start working with Corefy (V2), you need to create a User account.

2. Then, create an Organisation or join an existing one based on your needs.

3. When an Organisation is established, proceed with creating a Merchant account.

Verify Merchant Account Configuration

The Merchant account should be properly configured and operational.

Verify that:

• The Merchant account is active.

• The required currencies are enabled.

• The enabled currencies are available for payment processing.

• Only currencies configured on the Merchant account can be processed through the connector.

Generate an API Key

Generate an API key according to the target environment:

• Test API Key: for test and sandbox integrations.

• Live API Key: for production environments.

The API key should have access to:

• Merchant account

• Processing entities

This credential should be used by the Corefy Connector V1 to communicate with the Merchant account in Corefy V2.

Keep the API key secure and share it only with authorised users responsible for the configuration.

Configure the Webhook Callback URL

To receive payment status updates, create a Webhook on the Merchant account and configure the following callback URL: psp-ext.paycore.io/corefy/callback

Subscribe the Webhook to the Payment Request events.

These events are required for synchronising payment statuses between Corefy V2 and the Corefy Connector V1.

Enable Webhook Signature

1. After creating the Webhook, enable Webhook signature.

2. The generated signature is required during the Corefy Connector configuration on the V1 side.

3. This step is mandatory because the signature is used to:

4. Validate incoming callback requests.

5. Ensure secure communication between Corefy V1 and Corefy V2.

6. Prevent unauthorised callback processing.

7. Make sure to save the signature value, as it should be required when configuring the Connector.

Obtain the Checkout ID

1. Retrieve the Checkout ID from the Merchant account in Corefy V2.

2. Go to the Merchant account and switch to the Checkouts tab.

3. Select the needed Checkout and click it.

4. Navigate to the Integration tab and scroll to the Administration settings.

5. Copy the Checkout ID.

6. The Checkout ID is used by the Corefy Connector to redirect Customers to the appropriate Checkout during the payment flow.

7. You need to provide this value when configuring the Connector.

Configure Test Mode

1. The Test Mode setting should correspond to the type of API key used for the integration.

1. Ensure that the Test Mode configuration matches the environment and API key being used. An incorrect configuration may prevent successful payment processing.

Important!

By default, all returned Checkout URLs are redirected to the standard Corefy Checkout domain: checkout.eu.corefy.com If you use a custom White-Label Checkout domain and want Customers to be redirected to that domain instead, you must provide the corresponding Checkout domain constant during the Corefy Connector configuration. Otherwise, all payment flows will use the default Corefy checkout domain regardless of the Merchant Account settings.

Constants

If some parameters are not sent in the transaction creation request, they will take the values from the set constants.

Here is a list of constants with their corresponding parameters:

• White label domain → wl_domain [website]