---
title: "DirectPayment"
method: POST
path: "/v2/DirectPayment/{invoiceKey}/{paymentGatewayId}"
tags: ["Payments (V2)"]
---

# DirectPayment

`POST /v2/DirectPayment/{invoiceKey}/{paymentGatewayId}`

## Request

- Base URL: `https://apitest.myfatoorah.com`
- URL: `https://apitest.myfatoorah.com/v2/DirectPayment/{invoiceKey}/{paymentGatewayId}`
- Auth: HTTP bearer

Facilitates the payment process by directly executing payments using card details or saved tokens. Note: This endpoint can be used if your system PCI certified

## Path parameters

- `invoiceKey` string, required
- `paymentGatewayId` integer, required

## Request body

- object
  - `PaymentType` 'card' | 'token', required: Specify the payment type: 'card' for card payment, 'token' for tokenized payment.
  - `Bypass3DS` boolean: Specify whether this transaction should be verified by 3DS or not.
  - `SaveToken` boolean: Set to true to save card data and return a token for future use.
  - `Token` string: The token value to execute the transaction against. Required if PaymentType is 'token'.
  - `Card` object: Card details. Required if PaymentType is 'card'.
    - `Number` string: The 16 digits of the card that will be charged for the transaction.
    - `ExpiryMonth` string: Card expiry month (MM).
    - `ExpiryYear` string: Card expiry year (YY).
    - `SecurityCode` string: Card CVV / CVC.
    - `HolderName` string: Name on card.

## Response `200`

Payment processed 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
    - `Error` string
  - `Data` object
    - `Status` string: The transaction status in non-3DS flow
    - `ErrorMessage` string: In case of error, the error message returned from the gateway.
    - `PaymentId` string: The payment ID associated with the transaction.
    - `Token` string: If SaveToken is requested, this returns the token of the card.
    - `PaymentURL` string: The OTP link. You should redirect your customer to this page for 3DS verification.
    - `CardInfo` object
      - `Number` string: The card number that executed the payment, displays first and last 4 digits.
      - `ExpiryMonth` string: Card expiry month.
      - `ExpiryYear` string: Card expiry year.
      - `Brand` string: Card brand (VISA or Master).
      - `Issuer` string: The card issuer bank.

---

[API](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2.md) - [All operations](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2/revisions/4c0c2a3af558?raw)