POPBill Developers
Guide
e-Tax Invoice
Guide Getting Started API Integration

API Integration

Our service independently operates each TEST and PRODUCTION stages. We support the integration development by providing a TEST stage that operates the same functions as the PRODUCTION and has an identical condition as the actual service.

  • Independent development environment
  • Identical authentication information (LinkID, SecretKey) is used in both stages
  • Free test point (some restrictions apply)

Steps for Integration

  1. Application for integration : apply with a client’s business information.

    Followings are required information to enter for a development testing :

    1. 1) Company information– business registration number, company name, CEO name, industry of business, items of business, address
    2. 2) Account Information – ID, PW
      • POPBiLL service website(both TEST and PRODUCTION) accounts are generated with the entered information.
      • ID information cannot be modified once it is generated. Please register an account with information on behalf of a company, not an individual.
    3. 3) Person in charge information – name, email, contact number
  2. Set API Key : set it on an SDK file. [SDK Preference]

    A client will receive API Key after an application is submitted. Set information on an SDK to use POPBiLL API service.

    • LinkID : unique identification information to distinguish a client and it is used for client management such as account registration.
    • SecretKey : information that is used to prevent a forgery of an API communication protocol.

    Please do not expose an authentication information to any external sources as it contains unique information to distinguish a client.

  3. Register a certificate : register a certificate that is compatible with an eligible purpose in a test account. [Joint Certificate]

    An e-Tax invoice can be issued by digitally signing with a registered certificate. A client must pre-register an eligible certificate to TEST account to issue an invoice.

    Following is an available option to register a certificate.

    Can I test with different company information?

    You are required to register a test account to test with company that is different from the information on the submitted integration application. Followings is an option to register for a test account.

    - API : Register via [JoinMember - Register for an account] API.

    How to test if I cannot register my company’s joint certificate?
    • POPBiLL provides a mock certificate to test an issuance function. Please contact partner center if you cannot register your company’s joint certificate.
  4. Development Test : POPBiLL provides free test point required for development.

    By referring to the integration documentation and using the SDK where you set the authorization information, you can test all the available API services. POPBiLL provides free(some restrictions apply) test points, and you can additionally request for more point when there is no remaining left.

  5. Go-live request for PRODUCTION stage : you can immediately use the service on the day of the request for go-live
    1. 1) Once a test is completed, request a go-live to PRODUCTION stage.
    2. 2) For a go-live process, please contact the partner center to discuss about information.
    3. 3) After receiving the email on completion of a go-live, change the variable for SDK configuration setting.

      - You do not need to request for API Key for production setting. The initial information provided for the TEST stage identically applies to the PRODUCTION stage.

      - You can use both stages by simply changing a value(true/false) of IsTest variable on the SDK config.

      How to change SDK configuration setting?

      Change the IsTest value of the config(creates a service object of SDK) from “true” (TEST) to “false” (PRODUCTION). [SDK Preference]

    4. 4) Proceed with the PRODUCTION account sign up and preparatory tasks(registering certificate, charging points, etc.) to use POPBiLL API services in the live server.

    As the TEST stage is independently constructed from the PRODUCTION, any registered certificate and account cannot be transferred between the different stages.