Transaction Inquiry Documentation - minglepay/paystory_global GitHub Wiki

Transaction Inquiry

  • Inquiry request

    • Set the mid and merchant Key used for payment.
    • When payment status or payment information is needed, you can use the tid received from PayStory to check the payment status and payment information.
    • 💡 If tid was not saved due to TimeOut or other reasons, you can request inquiry with the order number (ordNo) instead of tid.
    • Even when conducting a transaction lookup using order number(ordNo), you should still send the tid parameter, and it's value should be set to empty.

  • HashData configuration

    🔒 When requesting inquiry, the integrity of the request data is verified using
    encrypted hashdata.

Parameter Algorithm Plain text
hashStr Hex(Sha256) mid + ediDate + tid + merchant key(merchantKey)

  • Inquiry request parameters

URL : https://pg.minglepay.co.kr/transaction
HTTP Method : GET
Content-Type : application/x-www-form-urlencoded; charset=utf-8

Parameter Description Required Size(Byte)
mid ${{\color{Red}\huge{\textsf{*}}}}$ Merchant ID O 10 Fixed
tid ${{\color{Red}\huge{\textsf{*}}}}$ Transaction ID O 30
hashStr ${{\color{Red}\huge{\textsf{*}}}}$ Hash256 encrypted value O 256
ediDate ${{\color{Red}\huge{\textsf{*}}}}$ Request date (yyyymmddhhmmss) O 14
ordNo Merchant order ID
💡 In case of cancel request with “ordNo” (not “tid”) 		Optional 40

  • Inquiry response parameters

Content-type: application/json
Data Type : String

Parameter Data Type Data Depth Description Size
(Byte)
resultCd Sting ■ Inquiry result code (0000 : success, others fail) 10
resultMsg String ■ inquiry result message 100
cnt String ■ Total numbers of Inquiry dataset N/A
resultData Json Array ■ Payment data set N/A
- resultCd String ■ ■ Result code (3001: Authorized, 2001: Canceled ) 10
- resultMsg String ■ ■ Result message 100
- goodsName String ■ ■ Goods name 100
- ordNo String ■ ■ Merchant order ID 40
- goodsAmt String ■ ■ Payment amount 20
- appNo String ■ ■ Authorization number 30
- appDtm String ■ ■ Authorization date (yyyymmddhhmmss) 14
- ordNm String ■ ■ Buyer name (First Name) 30
- cancelYN String ■ ■ Transaction Status N : Authorized, Y : Canceled 1
- fnNm String ■ ■ Card issuer name 20
- appCardCd String ■ ■ Card issuer code 2
- acqCardCd String ■ ■ Card acquirer code 2
- quota String ■ ■ Installment months e.g. 00 (direct), 03 (3 months). 2
- cardNo String ■ ■ Card number (6 digits in the middle of full number masked) 20
- mid String ■ ■ Merchant ID 10
- tid String ■ ■ Transaction ID 30
- currencyType String ■ ■ Currency (KRW: Korean Won , USD: US Dollar, CNY: Chinese Yuan) 10
- mbsReserved String ■ ■ Reserved field for merchant 255
- cpCd String ■ ■ Card code 2

  • Inquiry Response Example

{ "resultCd":"0000",
  "resultMsg":"조회성공",
  "cnt":"2",
  "resultData":[
                {"currencyType":"KRW","cpCd":"01","acqCardCd":"01","appNo":"60044981","mid":"pstest001m",...},
                {"currencyType":"KRW","cpCd":"01","acqCardCd":"01","appNo":"67107159","mid":"pstest001m",...}
               ]
}



⚠️ **GitHub.com Fallback** ⚠️