⌨ī¸Request cash receipt API

Requests cash receipt for a cash transaction.

A cash receipt is issued for the i'mport transaction number (imp_uid) of the cash transaction (virtual account, account transfer) processed through i'mport. The cash receipt amount is automatically applied as cash transaction amount. For a partially cancelled transaction, cash receipt is issued for the remaining balance.

Supported PGs
  • KG INICIS

  • NHN KCP

  • Settle Bank

  • NICE Payments

  • PAYJOA (Daou)

  • KICC

Requests cash receipt for a cash transaction.

POST https://api.ianport.kr/receipts/{imp_uid}

Path Parameters

NameTypeDescription

imp_uid*

String

i'mport transaction ID

Request Body

NameTypeDescription

identifier*

String

Cash receipt code

identifier_type

String

Cash receipt code type

person: social security number

business: business registration number

phone: mobile phone number

taxcard: National Tax Service cash receipt card

type

String

Cash receipt type

For income deduction (personal) : person

For proof of expenses (business) : company

Default: person

company_tel

String

Merchant's customer service phone

(Required for PayJoa only)

company_name

String

Merchant's business name

(Required for PayJoa only)

corp_reg_no

String

Merchant's business registration number

(Required for PayJoa only)

buyer_name

String

Customer name

buyer_email

String

Customer email

buyer_tel

String

Customer phone

tax_free

integer

Tax free amount

code * integer

Response code

0: success, Not 0: check the message

message * string

Response message

A non-zero code includes a message like 'Invalid payment info'.

response (ReceiptAnnotation, optional)

imp_uid *string

i'mport transaction ID

receipt_tid string

Cash receipt ID issued by PG

apply_num*string

Cash receipt ID issued by National Tax Service

type *string

Recipient type

  • Personal use: person

  • Business use: company

amount*integer

Cash receipt Amount

vat*integer

VAT

receipt_url string

Cash receipt URL

applied_at*integer

Issued at UNIX TIMESTAMP

cancelled_at integer

Cancelled at UNIX TIMESTAMP

Key request parameter description

identifier*String

Cash receipt code

Enter the National Tax Service cash receipt card, mobile phone number, social security number, or business registration number.

identifier_type*String

Cash receipt code type

Required for KICC and Settlebank only

Request for KG INICIS/NHN KCP/Nice Payments/PayJoa is automatically processed with only the identifier.

Response Model Schema
{
  "code": 0,
  "message": "string",
  "response": {
    "imp_uid": "string",
    "receipt_tid": "string",
    "apply_num": "string",
    "type": "person",
    "amount": 0,
    "vat": 0,
    "receipt_url": "string",
    "applied_at": 0,
    "cancelled_at": 0
 }
}

Last updated