⌨️Request barcode API

Requests issuance or registration of convenience store barcode.

Requests issuance or registration of convenience store barcode.

POST https://api.iamport.kr/cvs

A customer can make payment by presenting the barcode image or number at a convenience store.

Request Body

Name	Type	Description
merchant_uid*	String(40)	Order ID
amount*	double	Amount
barcode	String	Barcode
expired_at	integer	Convenience store payment deadline Unix Timestamp
name	String(40)	Product name
buyer_name	String(16)	Customer name
buyer_email	String(64)	Customer email
buyer_tel	String(16)	Customer phone
buyer_addr	String(128)	Customer address
buyer_postcode	String(8)	Customer zip code
pg	String	PG code
confirm_url	String	URL for checking whether payment is acceptable
notice_url	String	Notification URL for successful payment If not specified, the Notification URL set in Admin console is used.
custom_data	Array	Custom data

200: OK Success

PaymentResponse

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 (PaymentAnnotation, optional)

PaymentAnnotation

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.

imp_uid * string

i'mport payment transaction UID

merchant_uid * string

Order ID

pay_method * string

Payment method code

channel * string

Payment environment code

• pc: (authenticated) PC

• mobile: (authenticated) mobile

• api: recurring or non-authenticated

pg_provider * string

PG code

---

emb_pg_provider * string

Hub-type PG code

pg_tid * string

PG transaction ID

pg_id * string

PG MID

escrow boolean

Indicates an escrow payment

apply_num string

Credit card approval number

bank_code string

Bank code

bank_name string

Bank name

---

card_code string

Credit card code (KFTC Credit Card Codes: link )

card_name string

Credit card name

card_quota integer

Number of installments (0 means one-off)

card_number string

Masked credit card number

---

card_type string

Credit card type code

• 0: credit

• 1: check

vbank_code string

Virtual account bank code (refer to image below)

---

vbank_name string

Refund virtual account

vbank_holder string

Refund virtual account holder

vbank_date string

Refund virtual account expiration (UNIX timestamp)

vbank_issued_at string

Refund virtual account created at (UNIX timestamp)

name string

Product name

amount * integer

Order (payment) amount

cancel_amount integer

Cancelled amount

currency string

Currency

• USD

• KRW

• EUR

---

buyer_name string

Customer name

buyer_email string

Customer email

buyer_tel string

Customer phone

buyer_addr string

Customer address

buyer_postcode string

Customer zip code

custom_data string

echo data as JSON string

user_agent string

UserAgent of the device where payment is initiated

status * string

Payment status code

• ready

• paid

• cancelled

• failed

started_at * string

Payment started at (UNIX timestamp)

paid_at * string

Payment completed at (UNIX timestamp)

failed_at * string

Payment failed at (UNIX timestamp)

cancelled_at * string

Payment cancelled at (UNIX timestamp)

fail_reason string

Reason for failure

cancel_reason string

Reason for cancellation

receipt_url string

Credit card receipt URL

cash_receipt_issued  boolean

Option to automatically issue cash receipt

customer_uid string

customer_uid related to the payment transaction

customer_uid_usage string

customer_uid use code

• payment.scheduled: scheduled payment

• payment: payment

• issue: billing key issuance

cancel_history (Array[PaymentCancelAnnotation], optional):

Cancellation/partial cancellation history

PaymentCancelAnnotation

pg_tid * string

PG cancellation transaction ID

amount * integer

Cancelled amount

cancelled_at * string

Cancelled at (UNIX timestamp)

reason * string(256)

Reason for cancellation

receipt_url * string(300)

Cancellation receipt URL. Availability varies by PG.

401: Unauthorized Missing or invalid access token

{
    // Response
}

Key request parameter description

barcode string

Barcode number

If there is a barcode number generated/managed by the merchant, you can use it instead of getting one from GalaxiaMoneytree.

expired_at integer

Convenience store payment deadline

If not specified, default value specified in the contact with GalaxiaMoneytree is used.

pg String

PG code

Specify when using multiple GalaxiaMoneytree Merchant IDs as follows:

galaxia.{Merchant ID}

confirm_urlstring

A URL to check whether the convenience store payment can be made. If not specified, payment is considered acceptable and processed as successful.

The following data is sent to the URL via Webhook (HTTP POST).

200 response == acceptable / Other responses == Not acceptable

Webhook Body

{
    event : 'Galaxia.Cvs.Confirm',
    imp_uid : 'imp_123412341234',
    merchant_uid : 'asdfasdfasdf',
    status : 'ready',
    extra : {
        barcode : '11222222',
        payType : 'card' //card or cash
    }
}

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"
  }
}

Swagger Test Link

https://api.iamport.kr/#!/cvs/issueCvsPayment