Calculate Convenience Fee

POST/api/v1/fees

Calculate the convenience fee for a payment against an order based on the payment method and amount.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Request Body

Name	Type	Description
`amount`	`object`required	Monetary amount with currency.
`value`	`integer`required	Amount in the smallest currency unit (e.g., paisa for INR).
`currency`	`string`required	Three-letter ISO 4217 currency code.
`payment_method`	`string`required	Payment method for fee calculation.
`network_type`	`string`	Card network type for more specific fee calculation.

Response

Name	Type	Description
`data`	`object[]`	Array of convenience fee results per payment method/network combination.
`payment_method`	`string`	Payment method.
`fee_type`	`string`	Type of fee calculation.
`amount`	`object`	Monetary amount with currency.
`convenience_fee_breakdown`	`object`	Breakdown of the convenience fee.
`payable_amount`	`object`	Monetary amount with currency.
`payment_method_metadata`	`object`	Metadata about the payment method.

Status Codes

`200`	Convenience fee calculated successfully.
`400`
`401`
`422`	Unprocessable entity.
`500`

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/v1/fees \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": {
    "value": 50000,
    "currency": "INR"
  },
  "payment_method": "CARD",
  "network_type": "VISA"
}'

Run this request

Bearer token

Request body (JSON)

200 OK

{
  "data": [
    {
      "payment_method": "CARD",
      "fee_type": "PERCENTAGE",
      "amount": {
        "value": 50000,
        "currency": "INR"
      },
      "convenience_fee_breakdown": {
        "fee_amount": {
          "value": 50000,
          "currency": "INR"
        },
        "tax_amount": {
          "value": 50000,
          "currency": "INR"
        },
        "additional_fee_amount": {
          "value": 50000,
          "currency": "INR"
        },
        "maximum_fee_amount": {
          "value": 50000,
          "currency": "INR"
        },
        "applicable_fee_amount": {
          "value": 50000,
          "currency": "INR"
        }
      },
      "payable_amount": {
        "value": 50000,
        "currency": "INR"
      },
      "payment_method_metadata": {
        "network_type": "VISA",
        "card_type": "CREDIT"
      }
    }
  ]
}