API Transactions with Adobe Commerce

  Last updated: 

  Magento Commerce is now Adobe Commerce

The Trust Payments extension will continue to support both Magento Open Source and Adobe Commerce environments going forward. In our documentation, we will refer to this extension exclusively using the Adobe Commerce branding, but all instructions also apply when integrating using Magento Open Source.

Click here to learn more about Adobe Commerce.

 

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

 

  How to access

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

 

AdobeRequiredSettingsTop.png
Screenshot of Trust Payments extension settings

 

Required settings

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

adobeRequiredSettings.png

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.

magento-api-0110-03-en.png     

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

magento-api-0110-05-en.png

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.

Enable Notification: This must be set to "Yes.

Notification Password: You must use the same value as entered when configuring the notification in the MyST 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. If you do not have a Webservices user account, click here for instructions on how to register one.

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)

magento-api-2508-06-en.png

  PayPal

To configure PayPal, first click here and follow the instructions provided to enable this on your site reference. Once configured, set “Enable PayPal Payment” to “Yes” and enter your “Merchant Id”.

magento-api-0110-07-en.png

  Apple Pay

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


  1. 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.

    Our Support Team will update you once the registration process for the specified domains is complete.


  2. In the Apple Pay settings in Adobe Commerce, set "Enable Apple Pay" to "Yes" and enter your site reference into the "Merchant Id".


  3. Download the domain-verification file from this link:

      Click here to download


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

magento-api-0110-08-en.png

  Google Pay

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.

magento-api-0110-09-en.png

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.

magento-api-0110-10-en.png

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:

magento-api-0110-11-en.png

 

Other Settings

magento-api-0507-12-en.png

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 MyST) until actioned.

  The transaction will be suspended in MyST 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. Click here to 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.

magento-api-0110-13-en.png

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.

Was this article helpful?
0 out of 0 found this helpful