API v1FiatPe Home
FiatPeDocs
SERVER 2 SERVER

Methods API

Retrieve the payment methods and capabilities currently enabled for your FiatPe account.

Fetch available payment methods

Call the Methods API from your backend to discover the payment capabilities enabled for the credentials in the request. Use the response to display only the card networks, card types, UPI flows, banks, wallets, and PayLater providers that your account can currently accept.

Availability is account-specific.

A value of true means that capability is enabled for the authenticated account. Do not hardcode the example response or expose your secret key in frontend or mobile application code.

REQUEST

Curl
Copy
curl --location 'https://api.fiatpe.com/v1/payments/methods/' \
  --header 'Authorization: Basic <base64(api_key:secret_key)>'

Response

The response groups payment capabilities by method. Boolean values indicate whether a capability is enabled, while the Net Banking and wallet, Pay Later, and Cardless EMI objects map provider codes to their display names. The emi_plans object lists the EMI tenures and percentage rates available for each issuer. Within a plans object, the key is the tenure in months and the value is the percentage rate charged for that plan.

Only approved providers are returned.

The netbanking, wallet, paylater, and cardless_emi objects contain only the providers enabled for the authenticated account. If a provider is not present in the response, do not display or submit it as a payment option.

200 OK
Copy
{
  "entity": "methods",
  "card_networks": {
    "diners": false,
    "amex": false,
    "mastercard": false,
    "rupay": true,
    "visa": true
  },
  "card_type": {
    "debit": true,
    "credit": true,
    "prepaid": false
  },
  "card_subtype": {
    "business": false,
    "consumer": true,
    "premium": false
  },
  "upi": {
    "intent": true,
    "collect": true,
    "payer_account_type": {
      "bank_account": true,
      "credit_card": false
    }
  },
  "netbanking": {
    "ALLA": "Indian Bank (Erstwhile Allahabad Bank)",
    "AUBL": "AU Small Finance Bank",
    "BARB_R": "Bank of Baroda - Retail Banking",
    "BKID_C": "Bank of India - Corporate Banking",
    "CBIN": "Central Bank of India",
    "CNRB": "Canara Bank",
    "CORP": "Union Bank of India (Erstwhile Corporation Bank)",
    "CSBK": "Catholic Syrian Bank",
    "DCBL": "DCB Bank",
    "DEUT": "Deutsche Bank",
    "DLXB": "Dhanlaxmi Bank",
    "ESFB": "Equitas Small Finance Bank",
    "IBKL": "IDBI",
    "IDFB": "IDFC FIRST Bank",
    "IDIB": "Indian Bank",
    "INDB": "Indusind Bank",
    "IOBA": "Indian Overseas Bank",
    "JAKA": "Jammu and Kashmir Bank",
    "JSFB": "Jana Small Finance Bank",
    "KARB": "Karnataka Bank",
    "KKBK": "Kotak Mahindra Bank",
    "KVBL": "Karur Vysya Bank",
    "LAVB_R": "Lakshmi Vilas Bank - Retail Banking",
    "MAHB": "Bank of Maharashtra",
    "PUNB_R": "Punjab National Bank - Retail Banking",
    "RATN": "RBL Bank",
    "SIBL": "South Indian Bank",
    "SRCB": "Saraswat Co-operative Bank",
    "SVCB": "SVC Co-Operative Bank Ltd.",
    "TMBL": "Tamilnad Mercantile Bank",
    "UBIN": "Union Bank of India",
    "UCBA": "UCO Bank",
    "UJVN": "Ujjivan Small Finance Bank",
    "YESB": "Yes Bank"
  },
  "wallet": {
    "airtelmoney": "Airtel Money",
    "mobikwik": "Mobikwik",
    "olamoney": "Ola Money",
    "payzapp": "PayZapp",
    "phonepe": "PhonePe"
  },
  "paylater": {
    "amazonpay": "Amazon Pay",
    "hdfc": "HDFC",
    "lazypay": "LazyPay",
    "icic": "ICIC",
    "kkbk": "Kotak Mahindra Bank"
  },
  "cardless_emi": {
    "zestmoney": "ZestMoney",
    "earlysalary": "Fibe",
    "walnut369": "axio"
  },
  "emi_plans": {
    "AMEX": {
      "plans": {
        "3": 14,
        "6": 14,
        "9": 14,
        "12": 14,
        "18": 15,
        "24": 15
      }
    },
    "AUBL": {
      "plans": {
        "3": 14,
        "6": 14,
        "9": 14,
        "12": 14,
        "18": 14,
        "24": 14
      }
    },
    "BAJAJ": {
      "plans": {
        "3": 5
      }
    },
    "BARB": {
      "plans": {
        "3": 16,
        "6": 16,
        "9": 16,
        "12": 16,
        "18": 16,
        "24": 16
      }
    },
    "FDRL": {
      "plans": {
        "3": 15.99,
        "6": 15.99,
        "9": 15.99,
        "12": 15.99,
        "18": 15.99,
        "24": 15.99
      }
    },
    "HDFC": {
      "plans": {
        "3": 16
      }
    },
    "HDFC_DC": {
      "plans": {
        "3": 16,
        "6": 16,
        "9": 16,
        "12": 16,
        "18": 16
      }
    },
    "HSBC": {
      "plans": {
        "3": 15,
        "6": 15,
        "9": 15,
        "12": 15,
        "18": 15,
        "24": 15
      }
    },
    "ICIC": {
      "plans": {
        "3": 15.99,
        "6": 15.99,
        "9": 15.99,
        "12": 15.99,
        "18": 15.99,
        "24": 15.99
      }
    },
    "IDFB": {
      "plans": {
        "3": 16,
        "6": 16,
        "9": 16,
        "12": 16,
        "18": 16,
        "24": 16,
        "36": 16
      }
    },
    "INDB": {
      "plans": {
        "3": 17,
        "6": 16,
        "9": 16,
        "12": 16,
        "18": 16,
        "24": 16,
        "36": 16
      }
    },
    "KKBK": {
      "plans": {
        "3": 16,
        "6": 16,
        "9": 16,
        "12": 16,
        "18": 16,
        "24": 16
      }
    },
    "RATN": {
      "plans": {
        "3": 13,
        "6": 14,
        "9": 17,
        "12": 15,
        "18": 15,
        "24": 17
      }
    },
    "SBIN": {
      "plans": {
        "3": 17.25,
        "6": 17,
        "9": 17,
        "12": 17,
        "18": 17,
        "24": 17
      }
    },
    "SCBL": {
      "plans": {
        "3": 11.88,
        "6": 13,
        "9": 14,
        "12": 14
      }
    },
    "UTIB": {
      "plans": {
        "3": 17,
        "6": 17,
        "9": 17,
        "12": 17,
        "18": 17,
        "24": 17
      }
    },
    "YESB": {
      "plans": {
        "3": 16,
        "6": 16,
        "9": 16,
        "12": 16,
        "18": 16,
        "24": 16
      }
    },
    "onecard": {
      "plans": {
        "3": 16,
        "6": 16,
        "9": 16,
        "12": 16,
        "18": 16,
        "24": 16
      }
    }
  }
}

Response fields

FieldTypeDescription
entitystringIdentifies the response as a payment-methods resource.
card_networksobjectCard network availability. Present a network only when its value is true.
card_typeobjectAvailability of debit, credit, and prepaid cards.
card_subtypeobjectAvailability of business, consumer, and premium card subtypes.
upiobjectEnabled UPI flows and supported payer account types.
netbankingobjectOnly bank codes enabled for the authenticated account, mapped to customer-facing bank names. Send the selected returned code in an S2S Net Banking request.
walletobjectOnly wallet codes enabled for the authenticated account, mapped to customer-facing wallet names. Send the selected returned code in an S2S Wallet request.
paylaterobjectOnly Pay Later provider codes enabled for the authenticated account, mapped to customer-facing provider names.
cardless_emiobjectOnly Cardless EMI provider codes enabled for the authenticated account, mapped to customer-facing provider names.
emi_plansobjectEMI issuer codes mapped to their available plans. Each plans key is the tenure in months, while its numeric value is the percentage rate charged for that EMI plan. For example, "9": 14 represents a 9-month plan charged at a 14% rate.

Integration guidance

  1. Call this endpoint securely from your backend using the same credentials used to initiate payments.
  2. Render only capabilities marked as enabled. For Net Banking, wallets, Pay Later, and Cardless EMI, show only the providers included in their respective response objects.
  3. For EMI, allow the customer to select only an issuer and tenure present in emi_plans. Send the selected tenure as emi_duration.
  4. Use the object key, such as a bank or wallet code, in the payment request and use its value as the customer-facing label.
  5. Refresh the methods when starting a checkout session or according to a suitable application policy because account configuration can change.
  6. Handle an unavailable or failed Methods API request without presenting an unsupported payment option.