POPBill Developers
Guide

How to Issue

The types of cash receipt can be distinguished between the “cash receipt for transaction approval” type, that is issued for either income deduction usage or proof of purchase usage and “cash receipt for revocation” to cancel the partial or total amount of a transaction.

On principle, a cash receipt needs to be issued on the same-day as the occurrence date of a transaction. But for exceptional cases including a delayed payment, it can be issued within 5 days from the occurrence date including the very date of trade.

1. Cash Receipt for Transaction Approval

This type indicates when a seller(cash receipt affiliated business place) issues a cash receipt by using the identification number of a customer. The purpose of this issuance is a proof of purchase for a cash transaction.

  • Income Deduction Usage : when a customer type is an individual, this type is issued for year-end income tax deduction purpose
    └ Identification number : cell phone number/ resident registration number/ card number (credit card or a designated cash receipt card)
  • Proof of purchase Usage : when a customer type is a business proprietorship, this type is issued for VAT input tax deduction purpose
    └ Identification number : business registration number/ cell phone number/ card number (credit card or a designated cash receipt card)
Voluntary Issuance

This type can be issued with a designated National Tax Service code (010-000-1234) when a customer rejects the cash receipt issuance or the customer’s identification cannot be identified. It can be only used for income tax deduction purpose.

Process of Cash Receipt for Transaction Approval

The seller(cash receipt affiliated business place) writes and issue a cash receipt. Then, POPBiLL will automatically proceed the NTS filing process. [RegistIssue – Issue a cash receipt]

  • Flow Chart - Cash Receipt for Transaction Approval

Document ID Management System

The document ID is the identification number(assigned by the partner for internal management purpose) that prevents the duplicate issuance of a cash receipt.

Subject of Management Type Field Length Description
Partner / Program Provider Seller’s Document ID mgtKey 24 Allowed to include alphabets, numbers, ‘-’, ‘_’
POPBiLL NTS Confirmation Number confirmNum 9 Concurrently generates with the issuance of a cash receipt

To identify a cash receipt, you must use the combination of “date of trade” and "NTS confirmation number" as the unique identification value.

Status Check

POPBiLL provides two different methods to check the status of the cash receipt.

  • Webhook(Push) : program provider receives a real-time event message for any status change of cash receipt via designated callback URL [Webhook]
  • API(Polling) : program provider manually checks the status by periodically requesting the API

2. Cash Receipt for Revocation

This type indicates when a cash receipt is issued for a partial or total amount of a transaction. The total amount of the cancelled cash receipt cannot exceed the amount of the original approved cash receipt.

Process of Cancelled Issuance

If a seller wants to cancel the total amount of a cash receipt that is already issued, it can be proceeded by using ‘date of trade’ and ‘NTS confirmation number’ of the original approved cash receipt. For a partial amount cancellation, add ‘amount for cancellation’ in addition to the values mentioned above.