Feennex payment page scenario
Fundamentals
The payment form contains a set of fields with the order and payment details. In your shop, you need to place the form on the page that the payer sees after placing an order.
When the payer clicks the confirm button, the payment details are sent to Feennex.
Submitting the form starts the payment process on Feennex's side. The payer is then redirected to the Feennex payment page.
On the payment page, payers can select a payment method, enter their information if needed, and complete the payment.
Features
If the payment currency doesn't match your shop's payment direction, the payment page will convert the amount. Your shop will receive the payment in currency of the payment direction, and the payer will pay in their chosen currency.
If a new payment method is connected to your shop, it will be immediately available on the payment page.
Generating HTML form
To redirect the payer to the Feennex payment page, you need to generate an HTML form.
HTML form example
form name="Pay" method="post" action=" https://pay.feennex.com/en/pay" accept-charset="UTF-8
input type="hidden" name="amount" value="10.00"
input type="hidden" name="currency" value="840"
input type="hidden" name="shop_id" value="1"
input type="hidden" name="sign" value="2a966c9942652"
input type="hidden" name="shop_order_id" value="101"
input type="submit"
input type="hidden" name="description" value="Payment for order #123"
/form
Payment form parameters
URL address for form submission
Submit the form to https://pay.feennex.com/en/pay. Please note that the payment page supports multiple languages.
Form parameters
| Parameter | Format | Description |
|---|---|---|
| Required Parameters | ||
shop_id | Integer | Your shop's identifier in the Feennex system. Example: 5 |
amount | Number | Payment amount. Up to two digits after the decimal point. Example: 1.00 |
currency | Number | Payment currency. Example: 840 Possible currency values |
description | String | Payment description. Example: Payment for order #123. No more than 255 characters |
shop_order_id | String | Order number on your side. Example: h8fj38. Feennex may check the uniqueness of the order number depending on shop settings. No more than 255 characters |
sign | String | Request signature. Use only required parameters to generate signature |
| Optional Parameters | ||
payway | String | Payment direction through which the payment is made. Example: card_usd |
payer_account | String | Email or wallet number of the payer's account in Feennex. Example: [email protected] or 201494711279. If you send this parameter, only this account can make the payment. Only for payments from Feennex Wallet |
failed_url | String | URL where Feennex will redirect the payer after a failed payment. Example: https://feennex.com/failed |
success_url | String | URL where Feennex will redirect the payer after successful payment. Example: https://feennex.com/success |