Skip to content

2. Configuring a new payment method in Admin Panel

arti0090 edited this page Oct 31, 2024 · 5 revisions

Warning:

Sylius behavior for creating new payment gateways takes into account configuration of first created gateway with same name. That means, that when you create other configurations of the same type your data will be cloned into it.

To be sure of your data to be valid it is good to know:

  1. Write all the data one more time into the inputs when creating payment method.
  2. Remember that parent configuration is always first gateway with same type (tpay in our case).

Validation table

Field name Is required
Client ID Yes
Secret Yes
Cards API Only if Type is Card (on-site)
Type Yes
Merchant ID Yes
Google Merchant ID Only if Type is Google Pay
Apple Merchant ID Only if Type is Apple Pay
Security code Yes
Production mode Yes

How to add a new payment method that will use Tpay gateway:

  1. Go to admin panel and choose Payment Methods under Configuration section
  2. Click Create and choose Tpay

tpay_1

  1. Fill the values and channels you want to use

  2. For Gateway Configuration fill ClientID and Client Secret

You can find this values in your Tpay Admin Panel in Integrations->API under section Open Api Keys - Prod or Sandbox

tpay_2

  1. Fill the Notification security code

You can find it in your Tpay Admin Panel in Settings->Notification under section Security - Prod or Sandbox

  1. Choose the payment method Type of your choice. Currently implemented are:
Type Description Notes
Redirect to Tpay Synchronous redirect to Tpay gateway where the payment is processed
Card (on-site) It allows client to add Card data on checkout complete where later payment will be processed Requires Cards API
Blik It allows client to write BLIK 6-digit code where later after the challenge order will be processed
Redirect to bank It allows client to choose bank provider from list of available by Tpay and finish payment on bank site
Google Pay It allows client to pay using a Google Pay service Requires Merchant ID and Google Merchant ID
Apple Pay It allows client to pay using a Google Pay service Requires Merchant ID and Apple Merchant ID
Visa Mobile It allows client to pay using Visa Mobile by typing phone number on-site
  1. If you want to process payments using Cards fill out Cards API and choose Card (on-site) as Type

You can find this value in your Tpay Admin Panel in Integrations->API under section Cards API at the end of page - Prod or Sandbox

  1. If you want to process payments using Google or Apple Pay fill out Merchant ID and Merchant ID of service provider.

You can find this Merchant ID in your Tpay Admin Panel on top right corner near profile icon. For merchantID of Google or Apple see your merchant account or check out support of given provider

  1. You can choose if the created Gateway run in Production Mode

  2. After filling necessary data click Create button and your new Payment Method should be visible on list and customer should be able to choose it when choosing payment method on checkout