TrapyfyDocs

Niftipay Integration

Niftipay powers crypto payments, fiat card payments, QR checkout, on-ramping, and integrated checkout experiences within Trapyfy. Merchants configure all Niftipay settings directly inside the Trapyfy Payment Methods section.

Watch this walkthrough for a quick overview of the workflow.

Payment Methods list

Go to Payment methods in the sidebar to view and manage all payment methods. Each method shows its active status and POS visibility. Niftipay is the primary integrated method — the others (PayPal, Bank transfer, Cash on delivery) are manual or offline methods.

Payment Methods list showing PayPal, Bank transfer, Cash on delivery, and Niftipay rows with Active and Show in POS toggle columns

Each method can be independently activated and shown or hidden in POS and kiosk checkout.

Activating Niftipay

To activate Niftipay-powered payments in Trapyfy:

  1. Open the Niftipay payment method.
  2. Paste the Niftipay API key from your Niftipay merchant account into the API key field.
  3. Save the payment method.
  4. Enable the method from the Payment Methods list.
  5. Enable Show in POS only if the payment method should appear during a physical checkout flow, such as POS or kiosk checkout.
Edit Payment Method page for Niftipay showing Name, API key, Secret key (optional), Description, and Instructions for customers rich text editor

Crypto payments

Enable crypto payments to allow customers to pay with cryptocurrency. Each coin can be individually toggled. Crypto payments are confirmed once the blockchain transaction is successfully cleared and confirmed on-chain.

BTC
LTC
ETH
SOL
XRP
USDT
USDC
Niftipay settings showing Coins section with Crypto payments toggle on, individual coin toggles for BTC, LTC, ETH, SOL, XRP, USDT, USDC, and Crypto availability rules with country selector

USDT and USDC token support depends on your Niftipay ETH wallet having sufficient funds to cover gas fees.

Card payments

Card payments allow customers to pay by fiat card at checkout. Requirements and key details:

  • Niftipay API key must be saved in the Trapyfy payment method
  • A USDT ERC20 payout wallet must be configured for settlements
  • Card payment payouts are settled on a T+5 business day schedule
  • Card payments can be restricted to specific countries
  • Minimums and maximums can be set per currency for any payment type
  • Each payment type (crypto, card, on-ramp) can be individually enabled or disabled
Card payments settings showing country availability with Czech Republic, Germany, Malta, Spain, United Kingdom selected, per-currency min/max values (EUR, GBP, USD: min 1, max 999), Customer pays service fee toggle enabled, and Payout wallet section
Payout wallet section showing minimum and maximum order value per currency fields (EUR, GBP, USD), Customer pays service fee toggle enabled, and Payout wallet USDT ERC20 address input field

A payout wallet may be required for card payment settlement configuration where enabled.

EU restriction

Card fees cannot be passed onto customers in EU countries. The "Customer pays service fee" option is only applicable to non-EU markets.

On-ramping

On-ramping allows customers to purchase cryptocurrency during checkout — useful for customers who do not already hold crypto. Supported assets and country availability are configurable. Minimums and maximums can be set per currency.

On-ramping settings showing On-ramping toggle, supported coins (BTC, LTC, ETH, SOL, XRP, USDT, USDC), Show on-ramping in country selector with Czech Republic, Germany, Malta, Spain selected, and min/max order value fields

On-ramping availability varies by country. Where unavailable, a warning is displayed to the customer at checkout (e.g., "On-ramping is not available in the United Kingdom").

Availability rules

Payment methods can be limited by country. Only countries your organisation sells to are listed. Leaving the country selector empty will show the method in all supported countries. Minimums and maximums can be configured per currency to control when each payment method is offered.

Availability rules showing Show in countries with Czech Republic, Germany, Malta, Spain, United Kingdom selected, minimum and maximum order value per currency, and Trapyfy fiat integration section with Return URL and Failure URL fields

Trapyfy fiat integration

These URLs control where customers are redirected after completing or failing a fiat payment link checkout.

Return URL

Required. Customer is redirected here after a successful payment.

Failure URL

Optional. Customer is redirected here after a failed or cancelled payment attempt.

Click Save integration URLs after updating either URL field.

POS and kiosk payment visibility

Payment methods can be shown or hidden in POS and kiosk environments independently of their online checkout visibility. Toggle Show in POS on each method to control which options appear during in-person or self-service checkout. Country availability rules still apply.

For full kiosk setup including pairing devices and configuring inventory, see the POS and Kiosk guide.

Related pages

Need help?

Email [email protected] with your merchant name, store or payment reference, screenshots or error messages, and a short description of the issue.