---
title: "POST /payment-api/v1/Payment"
method: POST
path: "/payment-api/v1/Payment"
tags: ["Payment"]
---

# POST /payment-api/v1/Payment

`POST /payment-api/v1/Payment`

## Request body

- PaymentIntentRequestDto
  - `transactionId` string, required
  - `payerDetails` PaymentIntentPayerDetailsRequest
    - `payerTitle` string, nullable
    - `payerName` string, required
    - `payerEmail` string, required
    - `payerAddress` string, nullable
    - `payerCity` string, nullable
    - `payerCountry` string, required
    - `payerPostCode` string, nullable
    - `payerPhone` string, nullable
  - `travelerDetails` PaymentIntentTravelerDetailsRequest
    - `travelerName` string, nullable
    - `travelerEmail` string, nullable
    - `travelerAddress` string, nullable
    - `travelerCity` string, nullable
    - `travelerTitle` string, nullable
    - `travelerPhone` string, nullable
  - `paymentDetails` PaymentIntentDetailsRequest
    - `referenceNo` string, required
    - `currency` string, required
    - `country` string, nullable
    - `amount` number, required
    - `orderDate` string, date, required
    - `paymentDate` string, date-time, nullable
    - `description` string, nullable
    - `mode` 'Payment' | 'PayLater' | 'Token' | 'Terminal' | 'Authorize', required
    - `statementSuffix` string, nullable
    - `imageLink` string, nullable
    - `submitLabel` string, nullable
    - `transactionTypeId` string, nullable
    - `pmsPosting` boolean
    - `paymentToken` string, nullable
    - `promoCode` string, nullable
    - `paymentLinkExpiryDate` string, date-time, nullable
    - `presignedPaymentMethods` PaymentMethodType[], nullable
    - `hotelDetails` OrderHotelDetailsDto
      - `hotelName` string, nullable
      - `roomType` string, nullable
      - `mealType` string, nullable
      - `checkInDate` string, date-time
      - `checkOutDate` string, date-time
      - `ratePlanCode` string, nullable
      - `ratePlanDescription` string, nullable
      - `notes` string, nullable
    - `subscription` PaymentIntentSubscription
      - `type` 'Monthly' | 'Yearly'
      - `to` string, date-time, nullable
    - `paymentSchedule` PaymentIntentPaymentSchedule[], nullable
      - `label` string, nullable
      - `dateTime` string, date-time
      - `amount` number, double
    - `lineItems` PaymentIntentLineItemsRequest[], nullable
      - `itemRef` string, required
      - `currency` string, required
      - `amount` number, required
      - `description` string, nullable
      - `productCode` string, required
      - `tax` number, nullable
      - `amountAfterTax` number, nullable
      - `pmsLocator` string, nullable
      - `crsLocator` string, nullable
      - `mealType` string, nullable
      - `roomType` string, nullable
      - `ratePlanCode` string, nullable
      - `transactionTypeId` integer
      - `checkInDate` string, date-time, nullable
      - `checkOutDate` string, date-time, nullable
      - `metadata` object, nullable
      - `paymentSchedule` PaymentIntentPaymentSchedule[], nullable
        - `label` string, nullable
        - `dateTime` string, date-time
        - `amount` number, double
    - `acceptedCardDetails` PaymentIntentAcceptedCardDetails
      - `brand` string[], nullable
      - `issuer` string[], nullable
      - `tier` string[], nullable
      - `funding` string[], nullable
    - `payNowIsShown` boolean, nullable
    - `bookingSourceMappingId` integer, nullable
    - `sourceType` 'None' | 'Ows' | 'Cendyn' | 'Oracle'
  - `language` string, nullable
  - `returnUrlSuccess` string, nullable
  - `returnUrlCancel` string, nullable
  - `webhookUrl` string, nullable
  - `emailRequired` boolean, nullable
  - `version` 1 | 2

## Response `200`

Success

- PaymentIntentResponseDto
  - `encryptedPubKey` string, nullable
  - `paymentLinkKey` string, nullable
  - `paymentLink` string, nullable
  - `returnUrlSuccess` string, nullable
  - `returnUrlCancel` string, nullable
  - `paymentLinkExpiryDate` string, date-time
  - `paymentIntentId` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/iolpay/apis/iolpay-payment-api-public.md) · [All operations](https://skmtc.dev/iolpay/apis/iolpay-payment-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/iolpay/iolpay-payment-api-public/revisions/f14fdc43700a/schema)