Contract configuration

You can configure and manage your contract settings in your Merchant Portal. Open the section for your provider to learn how you can configure your contract with this provider on the sandbox environment.  Before you start, make sure you have the credentials for the provider's configuration that your provider has supplied. You'll need these details to complete your contract configuration in optile.

For most contracts you'll need to configure the optile's side and the provider's side to get the contract up and running. 

Stripe

To configure your Stripe contract you need to configure it on the optile and Stripe side. 

Follow these steps to configure your contract on sandbox:

1. Log in to your merchant portal. 
2. In the left-hand navigation, click Provider Contracts.
3. Click + New Contract.
4. Search for the provider and click on the provider's icon to select it. 
5. Select the methods and add the countries in which these methods will be available as per your contract. If the methods will be available in all countries, select Global. 
6. Click Continue. 
7. In the API Parameters section, enter the required data. You can leave the remaining fields blank.
   • API Gateway: https://api.stripe.com
   • apiKey: enter the key you've received from Stripe. 
8. Click Continue.
9. Select the currencies this contract will use, or leave All currencies selected. If the contract should only use a limited range of currencies, add the currencies you want to use. The selected currencies must match the currencies that you have activated with Stripe. 

10. Click Continue.

11. Add any costs and transaction limits that apply as per the contract. 

12. Click Finish.

You have finished configuring the contract. Now, click this contract in the contract list and activate it. 

Now, you need to configure the contract on the Stripe side to receive notifications and for the transaction status to get updated. 

1. Go to Stripe.com, and log in to your Stripe account. 
2. In the left-hand navigation, click Developers > Webhooks. 
3. Click + Add endpoint.
4. Enter the following URL in the Endpoint URL field replacing the example with your actual merchant code: https://api.sandbox.oscato.com/notification/STRIPE/<YourMerchantCode>/do.html
5. In the Events to send, click to receive all events.
6. Click Add endpoint.

Now, you can configure your transaction routing in optile to direct your transactions to specific payment providers and methods.

Kalixa

Follow these steps to configure your contract on sandbox. The configuration on live follows the same flow.

1. Log in to your merchant portal. 
2. In the left-hand navigation, click Provider Contracts.
3. Click + New Contract.
4. Search for the provider and click on the provider's icon to select it. 
5. Select the methods and add the countries in which these methods will be available as per your contract. If the methods will be available in all countries, select Global. 
6. Click Continue. 
7. In the API Parameters section, enter the required data. You can leave the remaining fields blank.
   • API Gateway: https://api.test.kalixa.com/PaymentRedirectionService/PaymentService.svc/pox/
   • merchantId: enter the unique merchant ID that you have received from Kalixa.
   • shopId: enter the shop ID that you have received from Kalixa.
   • agreeforLiabilityShift (optional): defaults to false. If selected, the liability will be shifted to metchant if, for example, the card is not 3D Secure enrolled. The payment will be completed even if LiabilityShift returned by PSP was 'false'.
   • is3DSec (optional): defaults to false. Select to enable 3D Secure authentication. Note that the debit for the MAESTRO payment method is supported only when 3D Secure is enabled in the contract.
   • isSynchronousCapture (optional): defaults to false. If the box is unselected, the status of transactions is updated to 'debited' when transactiona re automatically captured in Kalixa. This could takes up to a few days. If the box is selected, the status of the transactions is updated to 'debited' immediately without waiting automatic capture on Kalixa's side. We recommend selecting this setting. 
   • Login (optional): enter the credentials provided by Kalixa. 
   • Password (optional): enter the credentials provided by Kalixa. 
   • Security token (optional): enter the credentials provided by Kalixa. 
8. Click Continue.
9. Select the currencies this contract will use, or leave All currencies selected. If the contract should only use a limited range of currencies, add the currencies you want to use. The selected currencies must match the currencies that you have activated with Kalixa. 

10. Click Continue.

11. Add any costs and transaction limits that apply as per the contract. 

12. Click Finish.

You have finished configuring the contract. Now, click this contract in the contract list and activate it. 

You can move on to configuring your transaction routing in optile to direct your transactions to specific payment providers and methods.

Worldpay

To configure your Worldpay contract you need to configure it in the Worldpay portal and in optile. If you have multiple merchant codes from this provider, you need to create a separate contract for each code in optile. 

Start by configuring the contract in Worldpay. 

1. Log in to https://secure.worldpay.com/sso/public/auth/login.html.
2. In the Merchant Code drop-down, select the code for which you'll be configuring your contract. You need to repeat the steps below for every contract you want to configure in optile.
3. In Account > Profile, edit the default XML Password. have the new password at hand, because you'll need it further on in the configuration process. 
4. Go to Integration > Configuration Details and make sure the Capture Delay is set to Off. 
5. Open the Merchant Channel tab to configure how notifications will be sent to our OPG platform. 
6. Configure the Test section of the Merchant Channels as shown below
   
7. In the Address field, enter: https://api.sandbox.oscato.com/notification/WORLDPAY/{MERCHANT_CODE}/do.html, where {MERCHANT_CODE} is your optile merchant code.
8.  In the Merchant Channel Events section, activate all events in the http row. You only need to leave the REFUND_WEBFORM_ISSUED and REFUSED_BY_BANK boxes unselected. 
9. Save your changes. 

10. Change your mode to TEST.
 

Now, configure your contract in optile. 

1. Log in to your merchant portal. 

2. In the left-hand navigation, click Provider Contracts.
3. Click + New Contract.
4. Search for the provider and click on the provider's icon to select it. 
5. Select the methods and add the countries in which these methods will be available as per your contract. If the methods will be available in all countries, select Global. 
6. Click Continue. 
7. In the API Parameters section, enter the required data. You can leave the remaining fields blank.

• Leave the AUTOCAPTURE_ENABLED unselected.
• MAC-SECRET: Generate the secret on the Worldpay page:  https://secure.worldpay.com/sso/public/auth/login.html, and enter it in optile. 
• MERCHANT-CODE: Enter the code provided by Worldpay.
• MODE: For sandbox, enter TEST.
• Gateway URL: https://localhost

8. Click Continue.

9. Select the currencies this contract will use, or leave All currencies selected. If the contract should only use a limited range of currencies, add the currencies you want to use. The selected currencies must match the currencies that you have activated with Worldpay. 

10. Click Continue.

11. Add any costs and transaction limits that apply as per the contract. 

12. Click Finish.

You have finished configuring the contract. Now, click this contract in the contract list and activate it. 

You can move on to configuring your transaction routing in optile to direct your transactions to specific payment providers and methods.