Skip to main content

Group Payment via Feennex Wallet​

Before integration, please read the Get started with API section.

Create payment when paying with Wallet [/bill/create]​

Use this endpoint to create a payment to accept payments from Feennex Wallets.

If you want to accept the payment through other methods, create a payment using the endpoint Create payment.

To use this method, you need to generate a signature using the required request parameters: payer_currency, shop_amount, shop_currency, shop_id, and shop_order_id. The generated signature must be passed in the sign parameter.

Click the button at the end of the method description to view the request and response parameter details.

Request example

curl https://core.feennex.com/bill/create \
   -H 'Content-Type: application/json' \
   -d '{
          "description": "Payment for order #123", 
          "payer_currency": 840, 
          "shop_amount": "23.15", 
          "shop_currency": 840, 
          "shop_id": "3", 
          "shop_order_id": 4239, 
          "sign": "ad7fbe8df102b" 
       }'

Example of an error response

{
    "data": null,
    "message": "invalid sign",
    "error_code": 1,
    "result": false
}

Click the button below to view the endpoint parameters and request/response bodies.

POST Create payment when paying with wallet [POST]​

  • Request (application/json)

    • Attributes

      • payer_currency: 840 (number, required) - Currency of the payer's payment. This currency may differ from the shop's currency. Possible currency values
      • shop_amount: 23.15 (string, required) - Payment amount
      • shop_currency: 840 (number, required) - Currency in which the payment is credited to your shop. Possible currency values
      • shop_id: 3 (number, required) - Your shop's identifier in Feennex
      • shop_order_id: 123456789 (string, required) - Unique order number in your system. No more than 255 characters
      • sign: 32b2c32caa8ad (string, required) - Request signature
      • description: Payment for order (string, optional) - Payment description. No more than 255 characters
      • payer_account: 1a2b3c (string, optional) - Payer's Feennex account making the payment
      • lifetime: 43200 (number, optional) - Payment lifetime in minutes. When the payment expires, its status changes to Expired. If the payment isn't passed, the lifetime will be 43200 minutes
      • failed_url: https://feennex.com/failed (string, optional) - URL to which the payer is redirected after an failed payment. If you want to pass a URL in the request, remove the value from the corresponding address in shop settings in the dashboard
      • success_url: https://feennex.com/success (string, optional) - URL to which the payer is redirected after a successful payment. If you want to pass a URL in the request, remove the value from the corresponding address in shop settings in the dashboard
      • callback_url (string, optional) - URL to which a notification of successful payment is sent. If you want to pass a URL in the request, remove the value from the corresponding address in shop settings in the dashboard
      • callback_rejected_url (string, optional) - URL to which a notification of rejected payment is sent. If you want to pass a URL in the request, remove the value from the corresponding address in shop settings in the dashboard

    • Body

      { 
          "description": "Payment for order #123", 
          "payer_currency": 840, 
          "shop_amount": "23.15", 
          "shop_currency": 840, 
          "shop_id": "3", 
          "shop_order_id": 4239, 
          "sign": "ad7fbe8df102b" 
      }

  • Response 200 (application/json)

    • Headers

    • Body

      {
          "data": {
              "created": "Wed, 10 Apr 2024 14:18:19 GMT",
              "id": 26,
              "lifetime": 43200,
              "payer_account": null,
              "payer_currency": 643,
              "payer_price": 500,
              "shop_amount": 500,
              "shop_currency": 643,
              "shop_id": 3,
              "shop_order_id": "4239",
              "shop_refund": 465,
              "url": "https://wallet.feennex.com/en/bill/pay/Waptm"
          },
          "error_code": 0,
          "message": "Ok",
          "result": true
      }

    • Attributes (object)

      • data (object, required) - Object contains payment data
        • created: Wed, 10 Apr 2024 14:18:19 GMT (string, required) - Date of payment creation. Format: RFC 5322
        • id: 26 (number, required) - Unique identifier of the payment in Feennex
        • lifetime: 43200 (number, required) - Payment lifetime in minutes. When the payment expires, its status will be changed to Expired. Default value - 43200 minutes
        • payer_account: 1a2b3c (string, optional) - Feennex account of the payer who is making the payment. Returned if you passed this parameter in the request
        • payer_currency: 840 (number, required) - Currency in which the payer makes the payment. This currency may differ from the shop's currency. Possible currency values
        • payer_price: 23.15 (number, required) - Amount the payer must pay. Includes Feennex commission
        • shop_amount: 10.0 (number, required) - Payment amount
        • shop_currency: 840 (number, required) - Currency in which the payment is credited to your shop. Possible currency values
        • shop_id: 3 (number, required) - Identifier of your shop in Feennex
        • shop_order_id: 101 (string, required) - Unique order identifier in your system. No more than 255 characters
        • url: https://wallet.feennex.com/en/bill/pay/Waptm (string, required) - URL to which you need to redirect the payer
      • error_code: 0 (number, required) - Error code. Possible error codes
      • message: Ok (string, required) - Error description. Based on the value of this parameter, you can determine the success of the request and find out what went wrong
      • result: true (boolean, required) - Success of the request

Request payment status when paying with Wallet [/bill/shop_order_status]​

Use this endpoint to check the current status of a payment for which the payer made a payment using Feennex Wallet. More about payment statuses when paying with a Wallet

Important! Request the status no more often than once every 10 seconds.

To use this method, you need to generate a signature using the required request parameters: now, shop_id, and shop_order_id. The generated signature must be passed in the sign parameter.

Click the button at the end of the method description to view the request and response parameter details.

Request example

curl https://core.feennex.com/bill/shop_order_status \
   -H 'Content-Type: application/json' \
   -d '{
          "now": "2024-05-01 16:56:25.009469", 
          "shop_id": "1092", 
          "shop_order_id": "234234232323",
          "sign": "ad7fbe8df102b" 
       }'

Example response in case of an error

{
    "data": null,
    "message": "invalid sign",
    "error_code": 1,
    "result": false
}

Click the button below to view the parameters of the endpoint and the request and response bodies.

POST Request payment status when paying with Wallet [POST]​

  • Request (application/json)

    • Attributes

      • now (string, required) - Date and time when you send the request. Format: ISO 8601
      • shop_id: 1092 (number, required) - Your shop's identifier in Feennex
      • shop_order_id: 123456789 (string, required) - Unique order number in your system. No more than 255 characters
      • sign: 32b2c32caa8ad (string, required) - Request signature

    • Body

      { 
          "now": "2024-05-01 16:56:25.009469", 
          "shop_id": "1092", 
          "shop_order_id": "234234232323",
          "sign": "ad7fbe8df102b" 
      }

  • Response 200 (application/json)

    • Headers

    • Body

      {
          "data": 
          {
            "client_price": 1.16, 
            "created": "2024-10-20 14:01:28", 
            "description": "Main account", 
            "is_unique": true, 
            "payment_id": 852095, 
            "payway": "feennex_usd", 
            "processed": "2024-10-20 14:01:33", 
            "ps_currency": 840, 
            "ps_data": {
              "ps_payer_account": "201538122124"
            }, 
            "shop_amount": 1.1, 
            "shop_currency": 840, 
            "shop_id": 1092, 
            "shop_order_id": "234234232323", 
            "shop_refund": 1.1, 
            "status": 2
          }, 
          "error_code": 0, 
          "message": "Ok", 
          "result": true
      }

    • Attributes (object)

      • data (object, required) - Object contains payment data
        • client_price: 1.16 (number, required) - Amount actually transferred by the payer
        • created: 2024-10-20 14:01:28 (string, required) - Date and time of payment creation. Format – ISO 8601
        • is_unique (boolean, required) - Uniqueness of the order number on your shop's side. If you have already created a payment with this order number, false is returned. In this case, the endpoint returns information about the last payment made with a wallet payment.
        • payment_id: 852095 (number, required) - Payment identifier on the Feennex side
        • payway: feennex_rub (string, required) - Payment direction
        • processed (string, required) - Date of payment processing. Format: ISO 8601
        • ps_currency: 840 (number, required) - Currency received in the payment system
        • ps_data (object, required) - Additional information from the payment system, such as payer's account ps_payer_account: 201538122124 (string, required) - Payer's account in Feennex
        • shop_amount: 10.0 (number, required) - Payment amount
        • shop_currency: 840 (number, required) - Currency in which the payment is credited to the shop
        • shop_id: 3 (number, required) - Your shop's identifier in Feennex
        • shop_order_id: 101 (string, required) - Unique order number in your system. No more than 255 characters
        • shop_refund: 1.1 (number, required) - Amount credited to the shop's balance, in the account currency
        • status: 2 (number, required) - Payment status. More about statuses
        • description: Main account (string, optional) - Payment description. No more than 255 characters
      • error_code: 0 (number, required) - Error code. Possible error codes
      • message: Ok (string, required) - Error description. Based on this parameter's value, you can determine the success of the request and find out what went wrong
      • result: true (boolean, required) - Success of the request