Skip to main content

​
Payment Methods

Open Settings > Payment Methods.

​
How The System Works

Payment Methods controls the checkout options shown to users. Each payment method has a visible title, an infrastructure provider, a payment type, provider credentials, optional commission settings, and a callback URL. The page has two parts:
  • A list of existing payment methods with title, API type, publish date, and actions.
  • A drawer form for adding or editing a payment method.
After a payment method is saved, checkout can use it if the provider credentials are correct and the method is compatible with the selected checkout flow.

​
Add A Payment Method

  1. Click Add Payment Method.
  2. Enter the Title users will recognize during checkout.
  3. Choose the Infrastructure from the provider dropdown.
  4. Choose the Type. The type changes automatically for some providers.
  5. Fill the provider-specific credential fields.
  6. Review the callback URL shown by the panel.
  7. Decide whether commission should be reflected to the customer.
  8. Save the method.
  9. Test checkout with a small payment before making it public.

​
General Fields

FieldHow to fill it
TitleThe name shown in the payment method list and checkout. Use a clear name such as Credit Card, PayPal, Bank Transfer, or Manual Payment.
InfrastructureSelect the provider that will process the payment. Each provider reveals its own credential fields.
TypeDefines the payment category. Most providers use Credit Card, some use Wallet, PayTR EFT uses Bank/EFT, and Manual uses Manual.
Reflect commission to customerEnable this if the customer should pay the added commission.
Commission rate (%)Percentage commission added when reflection is enabled.
Fixed transaction feeFixed extra fee added when reflection is enabled.
Callback URLThe URL that the provider should call after payment. The panel shows it as /process/{provider} on your domain.

​
Supported Infrastructures

InfrastructureTypeRequired fields
ZonelyPayCredit CardSelect one or more ZonelyPay providers, set provider email if needed, review provider commission.
Tebex CheckoutCredit CardTebex username, Tebex private key.
PayPal CheckoutCredit Card or WalletPayPal Client ID, PayPal secret.
StripeCredit CardAPI key, secret key, webhook key.
CoinbaseWalletSecret key, webhook key.
IyzicoCredit CardAPI key, secret key, base URL.
PayTRCredit CardMerchant number, password, private key.
PayTR EFTBank/EFTMerchant number, password, private key for EFT.
ShopierCredit CardShopier user key, Shopier password.
ValletCredit CardUser, password, shop code, cryptographic hash.
ShipyCredit CardShipy password.
FreekassaCredit CardMerchant ID, secret key 1, secret key 2, API key.
WeePayCredit CardWeePay ID, API key, secret key.
ZalopayWalletApp ID, key 1, key 2.
PaymesCredit CardPublic key, secret key.
Paymes MobileWalletPublic key, secret key.
PaywantCredit CardAPI key, secret key.
Paywant MobileWalletAPI key, secret key.
SquareCredit CardAccess token, location ID.
MomoWalletPartner code, access key, secret key.
AaioCredit CardMerchant ID, secret key 1, secret key 2, API key.
ManualManualOne or more manual content blocks with title and content.

​
ZonelyPay Setup

ZonelyPay works differently from the other providers. Instead of typing one provider key, the panel loads a provider catalog and lets you select the payment providers you want to use. To configure ZonelyPay:
  1. Select ZonelyPay as the infrastructure.
  2. Choose the provider cards you want to offer.
  3. Add an email/contact value if the selected provider requires it.
  4. Review each provider commission rate and fixed fee.
  5. Enable Reflect commission to customer if customers should pay the extra commission.
  6. Save the payment method.
The selected ZonelyPay providers are stored together. If no provider is selected, the method may appear incomplete even if the payment method record exists.

​
Manual Payment Setup

Manual payment is used when the customer must follow instructions instead of completing an automatic online payment. To configure manual payment:
  1. Select Manual as the infrastructure.
  2. Add one or more manual content blocks.
  3. Give each block a short title.
  4. Write the payment instructions in the content area.
  5. Include bank account, IBAN, receiver name, note format, or proof instructions if needed.
  6. Save the method.
Manual payment hides callback and commission fields because the payment is not automatically confirmed by a provider.

​
Provider Notes

PayTR and PayTR EFT PayTR and PayTR EFT use separate credential fields. Use PayTR for card payments and PayTR EFT for bank transfer/EFT flow. Do not mix the normal PayTR credentials with the EFT-specific fields unless your provider account tells you to use the same values. Stripe and Coinbase Both use webhook keys. Configure the callback/webhook URL in the provider dashboard so payment status can return to the site. PayPal PayPal supports both Credit Card and Wallet type in the panel. Use the type that matches how you want customers to see the method. Zalopay, Momo, Paymes Mobile, Paywant Mobile, and Coinbase These are wallet-style providers. Make sure checkout text clearly tells users what wallet or app they will use. Freekassa and Aaio These require multiple secret values. Copy each value into the matching field exactly. Tebex Checkout Tebex requires username and private key. Test checkout after saving because delivery and checkout status depend on the external Tebex setup too.

​
Editing A Payment Method

Use the row action to edit an existing payment method. The drawer restores the selected infrastructure, type, saved variables, commission settings, manual content, and ZonelyPay provider selection when available. After editing:
  1. Save the method.
  2. Refresh checkout.
  3. Test the method again.
  4. If the provider uses a dashboard callback or webhook URL, confirm the provider still points to the correct callback.

​
Deleting And Reordering

Use Delete selected only when the payment method should no longer be available. If you are unsure, edit the method or remove it from checkout visibility first. Use Save changes after changing list order. The order can affect how payment methods appear to admins or users depending on the theme and checkout page.

​
Common Issues

Payment method is saved but checkout fails Check credentials, callback URL, provider dashboard settings, currency, and whether the provider account is active. Callback is not working Copy the callback URL shown in the panel and add it to the provider dashboard. It should use your domain and /process/{provider}. Manual payment instructions do not appear Make sure Manual is selected and at least one manual content block has a title or content. ZonelyPay shows no providers The provider catalog may not have loaded. Refresh the page and check network access to the ZonelyPay provider list. Commission is wrong Check both provider commission and the global commission fields. If Reflect commission to customer is enabled, the customer can see the added rate or fee.