DirectPayment

Endpoint

Overview

The "DirectPayment" endpoint is a POST request. It is used to facilitate the payment process for your buyers. Detailed functionality of how to use this endpoint is explained in the Direct Payment and Tokenization sections.

The endpoint on Swagger is: Payment_DirectPaymentAsync.

Now, we are going to declare the endpoint and its models along with each accepted parameter and possible value.

📘

Request Header

Add "Authorization": "Bearer {Token}" to request header. Token of demo configuration can be found here.


Request Model

The request is a POST request with the following parameters:

Input Parameter

Type

Description

PaymentType

string

It accepts 2 values as a string: "card", and "token".

Bypass3DS

boolean, optional

Specify either this transaction should be verified by 3DS or not.

SaveToken

boolean, optional

"true" or "false" to save card data and returns a token.

Token

string, optional

The token value that needs to execute the transaction against

Card

CardModel array, optional

📘

Card or Token Parameters

You have to provide at least one value of the two parameters:

  • You have to provide Card Model data if the PaymentType parameter is "card".
  • You have to provide the Token parameter value if the PaymentType parameter is "token".

CardModel

Input Parameter

Type

Description

Number

string

Represents the 16 digits of the card that will be charged for the transaction

ExpiryMonth

string

Card expiry month

ExpiryYear

string

Card expiry year

SecurityCode

string

Card CVV / CVC

HolderName

string

Name on card


Response Model

After viewing the Response Model that you will get as a result of your request, here, you will find full details about the Data Model of this API endpoint. Let's check it and its contents.

Response Field

Type

Description

Status

string

The transaction status

ErrorMessage

string

In case of error, the error message that is returned from the gateway.

PaymentId

string

The payment ID that is associated for the transaction.

Token

string

In case of "SaveToken" is requested, this value returns the token of the card.

PaymentURL

string

The OTP link. You should redirect your customer to this page.

CardInfo

CardInfoModel array

CardInfoModel

Response Field

Type

Description

Number

string

The card number that executed the payment, displays on the 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



Did this page help you?