---
title: "POST /payment-api/v1/Payment/pay-with-wallet-item"
method: POST
path: "/payment-api/v1/Payment/pay-with-wallet-item"
tags: ["Payment"]
---

# POST /payment-api/v1/Payment/pay-with-wallet-item

`POST /payment-api/v1/Payment/pay-with-wallet-item`

## Request

- Base URL: `https://api.iolpay.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.iolpay.com/payment-api/v1/Payment/pay-with-wallet-item`
- Auth: none declared

## Request body

- PaymentIntentWithWalletItemRequestDto
  - `walletItemToken` string, required
  - `previousTransactionId` string, nullable
  - `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`

OK

- ProceedPaymentResponseDto
  - `status` 'RequiresPaymentMethod' | 'RequiresConfirmation' | 'RequiresAction' | 'Processing' | 'RequiresCapture' | 'Canceled' | 'Succeeded' | 'Scheduled' | 'PartialRefund' | 'Refund' | 'DisputedNeedsResponse' | 'DisputedUnderReview' | 'DisputedChargeRefunded' | 'DisputedWon' | 'DisputedLost' | 'DisputedCanceled' | 'DisputedExpired' | 'DisputedWarningClosed' | 'DisputedAccepted' | 'DisputedArbitrationSentToScheme' | 'DisputedEvidenceAcknowledgedByScheme' | 'DisputedEvidenceSubmitted' | 'DisputedResolved' | 'Voided' | 'DisputedEvidenceRequired' | 'DisputedArbitrationEvidenceSubmitted' | 'DisputedArbitrationWon' | 'DisputedArbitrationLost'
  - `paymentType` 0 | 1 | 2 | 3 | 4
  - `clientSecret` string, nullable
  - `paymentMethodExternalId` string, nullable
  - `accountPublicKey` string, nullable
  - `accountId` string, nullable
  - `confirmation3dsDevelopmentLink` string, nullable
  - `metadata3ds` string, nullable

## Other responses

- `400`: Bad Request

## Changes

- **2026-10-14** `34391e946cf7`: 4 info
  - added the new optional request property `previousTransactionId` (media type: application/json-patch+json)
  - added the new optional request property `previousTransactionId` (media type: application/json)
  - added the new optional request property `previousTransactionId` (media type: text/json)
  - added the new optional request property `previousTransactionId` (media type: application/*+json)
- **2026-09-29** `f34ad761aad1`: 3 info
  - added the optional property `errors/NETWORK_TOKEN_UNUSABLE` to the response with the `400` status (media type: text/plain)
  - added the optional property `errors/NETWORK_TOKEN_UNUSABLE` to the response with the `400` status (media type: application/json)
  - added the optional property `errors/NETWORK_TOKEN_UNUSABLE` to the response with the `400` status (media type: text/json)

[Operation history](https://skmtc.dev/iolpay/apis/iolpay-payment-api-public/changes/payment-api/v1/Payment/pay-with-wallet-item/post.md)

---

[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.dev/iolpay/apis/iolpay-payment-api-public/revisions/34391e946cf7?raw)