---
title: "Mark payment as refunded"
method: POST
path: "/api/v1/payment-intents/{paymentIntentId}/mark-as-refund"
tags: ["Payment Intents"]
---

# Mark payment as refunded

`POST /api/v1/payment-intents/{paymentIntentId}/mark-as-refund`

Mark payment as refunded

## Path parameters

- `paymentIntentId` string, required

## Request body

- MarkPaymentAsRefundedDto
  - `markRefundedComment` string

## Response `200`

- PaymentIntentDto
  - `id` string, required
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `organizationId` string, uuid, required
  - `amount` integer
  - `amountReceived` integer
  - `currency` 'usdc' | 'usdt' | 'pyusd' | 'eurc' | 'brett' | 'dai' | 'btc' | 'eth' | 'matic' | 'bnb' | 'sol' | 'busd' | 'trx' | 'food' | 'bonk' | 'wif' | 'goat' | 'spx' | 'truf' | 'pengu' | 'usd' | 'inr'
  - `status` 'requires_payment_method' | 'requires_confirmation' | 'requires_action' | 'processing' | 'requires_capture' | 'canceled' | 'succeeded', required
  - `paymentMethodId` string, uuid, required
  - `description` string
  - `paymentMethod` PaymentMethodDto
    - `id` string, required
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `assetId` string, uuid, required
    - `asset` AssetDto, required
      - `id` string, required — Asset id
      - `name` string, required — Asset name
      - `chainId` number, required — Asset chain id
      - `address` string, required — Asset address on chain
      - `currency` 'usdc' | 'usdt' | 'pyusd' | 'eurc' | 'brett' | 'dai' | 'btc' | 'eth' | 'matic' | 'bnb' | 'sol' | 'busd' | 'trx' | 'food' | 'bonk' | 'wif' | 'goat' | 'spx' | 'truf' | 'pengu' | 'usd' | 'inr', required
      - `symbol` string, required — Asset symbol
      - `decimals` number, required — Asset decimals in which it is represented on chain
      - `coingeckoId` string — Asset coingecko id
      - `superToken` SuperTokenDto
        - `address` string, required — SuperToken's address
        - `decimals` number, required
        - `symbol` string, required — SuperToken's symbol
      - `isEIP5827Supported` boolean, required — Is EIP5827 supported
    - `type` 'superfluid' | 'wallet' | 'allowance_based_recurring' | 'stripe' | 'binance_pay', required
    - `accountAddress` string
    - `billingDetails` FullAddressDetailDto
      - `name` string — The name
      - `email` string — The email
      - `phone` string — The phone
      - `organizationName` string — The organization name
      - `address` AddressDetailDto
        - `line1` string
        - `line2` string
        - `city` string
        - `state` string
        - `postalCode` string
        - `country` string
    - `customerId` string, uuid
    - `options` object
  - `paymentMethodTypes` PaymentMethodType[]
  - `transferAccountAddress` string
  - `transactions` TransactionDto[], required
    - `type` 'incoming' | 'outgoing' | 'event' | 'transfer', required
    - `transactionRelayId` string — Transaction relay id
    - `transactionHash` string — Transaction hash
    - `nonce` number — Transaction nonce
    - `gasLimit` number — Transaction gas limit used in payment
    - `validUntil` string — Transaction valid until
    - `fromAddress` string, required — Transaction from address
    - `toAddress` string, required — Transaction to address
    - `currency` 'usdc' | 'usdt' | 'pyusd' | 'eurc' | 'brett' | 'dai' | 'btc' | 'eth' | 'matic' | 'bnb' | 'sol' | 'busd' | 'trx' | 'food' | 'bonk' | 'wif' | 'goat' | 'spx' | 'truf' | 'pengu' | 'usd' | 'inr', required
    - `createdAt` string, date-time — Transaction created at
    - `amount` integer — Transaction amount in 8 decimals
    - `amountRaw` string, required — Transaction amount raw received from alchemy
    - `assetId` string, required — Transaction asset id
    - `asset` CheckoutSessionAssetDto, required
      - `id` string, required
      - `name` string, required
      - `address` string, required
      - `chainId` number, required
      - `currency` 'usdc' | 'usdt' | 'pyusd' | 'eurc' | 'brett' | 'dai' | 'btc' | 'eth' | 'matic' | 'bnb' | 'sol' | 'busd' | 'trx' | 'food' | 'bonk' | 'wif' | 'goat' | 'spx' | 'truf' | 'pengu' | 'usd' | 'inr', required
      - `symbol` string, required
      - `decimals` number, required
      - `coingeckoId` string
      - `isPublic` boolean, required
      - `superToken` SuperTokenDto
        - `address` string, required — SuperToken's address
        - `decimals` number, required
        - `symbol` string, required — SuperToken's symbol
      - `chain` ChainSlimDto, required
        - `id` number, required — Chain id
        - `name` string, required — Chain name
        - `icon` string, required — Chain icon
        - `currency` 'usdc' | 'usdt' | 'pyusd' | 'eurc' | 'brett' | 'dai' | 'btc' | 'eth' | 'matic' | 'bnb' | 'sol' | 'busd' | 'trx' | 'food' | 'bonk' | 'wif' | 'goat' | 'spx' | 'truf' | 'pengu' | 'usd' | 'inr', required
        - `blockExplorerTransactionUrl` string, required — Chain block explorer transaction url
        - `blockExplorerName` string, required — Chain block explorer name
        - `type` 'evm' | 'solana' | 'tron' | 'stripe' | 'binance_pay', required
        - `isBeta` boolean, required — Is beta asset
    - `transactionUrl` string — Transaction url
  - `paymentReceipt` PaymentReceiptDto
    - `id` string, required
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `organizationId` string, uuid, required
    - `paymentIntentId` string, uuid, required
    - `name` string
    - `receiptNumber` string, required
    - `uri` string
  - `canceledAt` string, date-time
  - `cancellationReason` string
  - `stripe` StripeDataDto
    - `paymentIntentId` string
    - `receiptUrl` string
    - `cardLast4` string
    - `displayName` string
  - `isMarkRefunded` boolean, nullable
  - `markRefundedAt` string, date-time, nullable
  - `markRefundedComment` string, nullable

## Other responses

- `500`

---

[API](https://skmtc.net/copperx/apis/copperx-api-2.md) · [All operations](https://skmtc.net/copperx/apis/copperx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/copperx/copperx-api-2/revisions/c0bfbc37fb98/schema)