⌨ī¸Cancel payment API

Cancels a payment in full or partially regardless of the payment method and PG.

Cancels an approved payment.

POST https://api.iamport.kr/payments/cancel

Credit card/instant account transfer/mobile micropayment: cancellation is processed immediately.

Virtual account: if you provide the refund account information, the refund information will be registered with PG and processed on the next business day. (Requires virtual account special service contract)

Request Body

NameTypeDescription

imp_uid*

String(32)

ChaiPort transaction ID

reason

String(256)

Reason for cancellation

checksum

Double

Refundable amount

amount

Double

Amount to refund (Full refund if null)

merchant_uid

String(40)

Order ID (Required if imp_uid is null)

tax_free

Double

Tax free amount out of amount (0 if null)

refund_bank

String(4)

Refund account bank code (Refer to bank codes list below, required for virtual account cancellation)

refund_holder

String(16)

Refund account holder (Required for virtual account cancellation)

refund_account

String(16)

Refund account number (Required for virtual account cancellation)

refund_tel

String(16)

Refund account holder's phone number (Required for virtual account cancellation and Smartro PG)

Key parameters

imp_uid & merchant_uid

At least one of these parameters must be specified.

checksum integer

Refundable amount

The checksum is used to check whether the refundable amount is the same between the API requester and the i'mport server. If they do not match, the refund request will fail. If the checksum is null, the verification is not performed.

amount * integer

Amount to cancel

If not specified, a full refund is requested.

Response Model Schema
{
  "code": 0,
  "message": "string",
  "response": {
    "imp_uid": "string",
    "merchant_uid": "string",
    "pay_method": "string",
    "channel": "pc",
    "pg_provider": "string",
    "emb_pg_provider": "string",
    "pg_tid": "string",
    "pg_id": "string",
    "escrow": true,
    "apply_num": "string",
    "bank_code": "string",
    "bank_name": "string",
    "card_code": "string",
    "card_name": "string",
    "card_quota": 0,
    "card_number": "string",
    "card_type": "null",
    "vbank_code": "string",
    "vbank_name": "string",
    "vbank_num": "string",
    "vbank_holder": "string",
    "vbank_date": 0,
    "vbank_issued_at": 0,
    "name": "string",
    "amount": 0,
    "cancel_amount": 0,
    "currency": "string",
    "buyer_name": "string",
    "buyer_email": "string",
    "buyer_tel": "string",
    "buyer_addr": "string",
    "buyer_postcode": "string",
    "custom_data": "string",
    "user_agent": "string",
    "status": "ready",
    "started_at": 0,
    "paid_at": 0,
    "failed_at": 0,
    "cancelled_at": 0,
    "fail_reason": "string",
    "cancel_reason": "string",
    "receipt_url": "string",
    "cancel_history": [
      {
        "pg_tid": "string",
        "amount": 0,
        "cancelled_at": 0,
        "reason": "string",
        "receipt_url": "string"
      }
    ],
    "cancel_receipt_urls": [
      "string"
    ],
    "cash_receipt_issued": true,
    "customer_uid": "string",
    "customer_uid_usage": "issue"
  }
}

Last updated