---
title: "InitiatePayment"
method: POST
path: "/v2/InitiatePayment"
tags: ["Payments (V2)"]
---

# InitiatePayment

`POST /v2/InitiatePayment`

Retrieves all available and enabled payment methods of your portal account with the commission charge that the customer may pay on the gateway. This endpoint does not execute or store any payment information, it just gets the proper information based on your MyFatoorah profile and calculates the service charges.

## Request body

- object
  - `InvoiceAmount` number — The transaction amount you need to charge your customer after applying coupon codes, taxes, fare updates, and so on.
  - `CurrencyIso` 'KWD' | 'SAR' | 'BHD' | 'AED' | 'QAR' | 'OMR' | 'JOD' | 'EGP' — The currency code that you need to charge your customer through. MyFatoorah will calculate the total amount of the invoice for this currency after applying the exchange rate.

## Response `200`

Payment methods retrieved successfully

- object
  - `IsSuccess` boolean — Indicates if the request was successful.
  - `Message` string — Response message associated with the request.
  - `ValidationErrors` object[] — List of validation errors, if any.
    - `Name` string — The name of the field with validation error.
    - `Error` string — The validation error message.
  - `Data` object
    - `PaymentMethods` object[] — List of available payment methods with their details and service charges.
      - `PaymentMethodId` integer — The payment method ID that is used in MyFatoorah system to identify the method of payment.
      - `PaymentMethodAr` string — Payment method Arabic name.
      - `PaymentMethodEn` string — Payment method English name.
      - `PaymentMethodCode` string — Code that refers to the payment method.
      - `IsDirectPayment` boolean — Indicates if this payment method supports Direct Payment.
      - `ServiceCharge` number — The transaction service charges based on the settings in the portal profile.
      - `TotalAmount` number — The total amount that you should send before calling Execute Payment including the service charges after calculating it.
      - `CurrencyIso` string — The currency code that you have sent in CurrencyIso.
      - `ImageUrl` string — Payment icon URL that you can use to display it in your page for the customers.
      - `IsEmbeddedSupported` boolean — Indicates if this payment method supports Embedded Payment.
      - `PaymentCurrencyIso` string — The currency of the gateway in which the payment will be made.

---

[API](https://skmtc.net/myfatoorah/apis/myfatoorah-api-v3.md) · [All operations](https://skmtc.net/myfatoorah/apis/myfatoorah-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myfatoorah/myfatoorah-api-v3/revisions/994a74287a16/schema)