---
title: "PATCH /payment-api/v2/payment"
method: PATCH
path: "/payment-api/v2/payment"
tags: ["Payment"]
---

# PATCH /payment-api/v2/payment

`PATCH /payment-api/v2/payment`

## Request body

- ProceedPaymentRequestDto
  - `pubKey` string, required
  - `paymentMethodId` string, nullable
  - `paymentMethodType` 'Card' | 'EvyPay' | 'AliPay' | 'WeChatPay' | 'Giropay' | 'GooglePay' | 'ApplePay' | 'Tamara' | 'Przelewy24' | 'Ideal' | 'Sofort' | 'Bancontact' | 'Multibanco' | 'Eps' | 'AliPayCN' | 'PostFinance' | 'Paypal'
  - `currency` string, nullable
  - `country` string, nullable
  - `saveCard` boolean
  - `zip` string, nullable
  - `card` ProceedPaymentCardItemRequestDto
    - `cardNumber` string, required
    - `cardHolderName` string, nullable
    - `cvc` string, nullable
    - `expirationMonth` integer, required
    - `expirationYear` integer, required
    - `brand` string, nullable
    - `countryIso` string, nullable
  - `paymentSchedule` ProceedPaymentScheduledPaymentDto[], nullable
    - `id` integer
    - `currencyToPay` string, nullable
  - `isFullOrderAmountPaid` boolean
  - `brand` string, nullable
  - `cardDesciption` string, nullable
  - `forceAuth` boolean, nullable
  - `paymentProviderType` 'Stripe' | 'CitiBank' | 'Checkout' | 'EvyPay' | 'Mpgs' | 'PayGate'
  - `useZeroAmount` boolean, nullable
  - `recurringPayment` boolean, nullable
  - `tokenData` string, nullable
  - `userAgent` string, nullable

## Response `200`

Success

- 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

---

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