API Transactions with Adobe Commerce – Trust Payments

Unfortunately, the product documented here is currently only available in English.

How to access

Sign in to your Store Admin.
On the Admin Sidebar, select the Trust Payments logo.
Navigate to Stores > Configuration.
On the next page, navigate to Sales > Payment Methods.
On the next page, expand the "OTHER PAYMENT METHODS" section, then select the "Configure" button next to the Trust Payments extension.
Expand the "API" section.

Screenshot of Trust Payments extension settings

Required settings

Expand "Required Settings" to view the settings you can configure.

Enabled: Set to “Yes” to enable this payment method to be displayed in checkout.

Animated card: When enabled, this will display an illustration of the card on screen that updates in real time as the customer fills out their card details.

Title: Enter the title of this payment method to be displayed on the checkout.

AccountCheck: An Account Check request allows a card to be validated by checking the cardholder’s first line of address, the cardholder’s postcode and the security code, to ensure the details entered by the customer match those stored on the issuing bank's records.

Pan Icon: Set to "Yes" for the relevant card brand logo to displayed in the card number field as the customer types.

Card Input Inline: Set to "Yes" for card number, expiry date and security fields to all be displayed on a single line to save space.

If you have not done so already, you must follow these instructions on how to set up a URL notification in the Rule Manager.
Failure to do so will prevent orders from being processed.

Enable Notification: This must be set to "Yes.

Notification Password: You must use the same value as entered when configuring the notification in the Rule Manager. This password is to prevent your notifications from being modified by unauthorised users.

Test Environment: Use this setting to switch between test and live environments.

Site Reference: You must enter your unique Trust Payments site reference.

When setting up the Adobe Commerce extension for the first time, it is strongly recommended that you specify your test site reference (e.g. “test_site12345”) in the "Site Reference" field. This allows you to process test payments to our test bank to ensure your implementation works as expected. When you are ready to go live, you will need to change this to be your live site reference (e.g. “site24680”).

Web Services Username and Web Services Password: Enter your Webservices username and password in these fields. This is required to authenticate your requests with Trust Payments. Learn how to register a Webservices user account.

JWT Username and JWT Secret Key: You will need a user account with the role “Webservices JWT” to create the token. If this user account has not already been provided, please request that one is created for your site reference by contacting our Support Team.

The contents of fields "Web Services Password", "JWT Secret Key" & "Site Security Password" are masked with * for security reasons.

Optional settings

Expand "Optional Settings" to view the settings you can configure.

Alternative Payment Methods (APM)

Apple Pay

Follow the steps below to enable Apple Pay on our Adobe Commerce extension:

Have your authorised contact reach out to our Support Team and request to have Apple Pay enabled on your site reference(s). In your email, we require you to attach a CSV file that contains a list of all of the site references you intend to register and their associated domain(s).

The format of the CSV file must be as follows:
```
Site reference, Domain name
```
For example:
```
site10001, example.com
test_site10003, example.com
```
Please include all relevant test and live site references and domains in the file.
- You can register up to 99 domains per site reference.
- We support subdomains (e.g. shop.example.com) and register them as provided.
Our Support Team will update you once the registration process for the specified domains is complete.
In the Apple Pay settings in Adobe Commerce, set "Enable Apple Pay" to "Yes" and enter your site reference into the "Merchant Id".
Download the domain-verification file from this link:

Download the domain-verification file
In the Apple Pay settings in Adobe Commerce, select "Choose file" by "Domain Association" and upload the domain-verification file.

Google Pay

Requirements

You will need to have registered a Google Pay business account using the Google Pay Business Console.
Sign in to the Google Pay Business Console and ensure the Business Profile has been completed and that the website has been registered with the Google Pay API.

Open the Google Pay Business Console (link to external site)

To begin your integration with Google Pay, you will need to confirm/request the following details from
our Support Team.

Confirm your acquiring bank supports Google Pay as a payment option.
Ensure Google Pay is enabled on your site reference.
Ensure you have a valid JWT username and Secret.

To start testing Google Pay transactions, follow the steps below:

Set “Enable Google Pay" to “Yes”.
Provide your "Merchant Id" (this is provided by Google).
Set your "Merchant Name" to be your company name (e.g. "My Company Ltd.").
Select your "Allowed Payment Types." If you do not know this, please contact our Support Team to confirm.
Finally, customise the appearance of the Google Pay button by selecting the options available within "Button Type" and "Button Color".

When configured correctly, the Google Pay button will be displayed on your checkout.

Tokenization Settings

Use Tokenization: Enabling this feature allows your customers to store their card for future use.

To enable this, please select “Yes”. When enabled, this will display a tick box on the selected payment method to give the customer the option to store their payment card for future purchases on your site reference.

Following a successful transaction when the customer opted to save their card for later, the saved card(s) should look like this on their next checkout:

Other Settings

Application Countries: This payment method can be enabled for all countries or for a specified subset of countries.

Payment Action: Gives you the ability to allow Authorize Only payments or Authorize & Capture.
If Authorize Only is selected, processed payments will initially be shown as “Pending” in the Store Admin (and “Suspended" in Portal) until actioned.

The transaction will be suspended in Portal and will not be captured by your acquiring bank unless action is taken. Admin must manually create the invoice to capture. If action is not taken after 7 days, the transaction will be cancelled. Learn more about Payment Action types.

Settle Status and Settle Due Date: If Authorize & Capture is the selected "Payment action", you will need to set a value for “Settle Status” and “Settle Due Date”. This means the invoice will be created following a successful transaction.

Show Icon: When enabled, a payment extension logo will be displayed next to the API payment method (this logo is defined in the "API Secure Trading Logo" setting described below).

API Logo: Choose an image you wish to display next to the API payment method on your checkout.

Sort Order: The ordering of the payment methods on your checkout. The value ‘1’ will cause the API payment method to be displayed first.