✅ WeChat Pay is a simple payment method using QR code and digital wallet serviced by the WeChat.

• ⚠ Notice

  • ✔ Merchants must develop in an environment where a web browser is available,
         because WeChat Pay requires that buyer to scan the QR Code using the WeChat Pay app.
  • ✔ Users must have WeChat app installed in advance for payment.
  • ✔ Users proceed with payment by scanning QR code created by Pay-Story with URL information.

QR Code example

• Payment Flows

  • 1️⃣ Merchant to create payment data including forgery prevention.
    • User enters payment information to a web page configured by the merchant.
      
  • 2️⃣ Authentication and Authorization
    • Merchant processes the payment information and merchant information received from the user and sends authentication request to Paystory.
    • Pay-Story creates a QR code and displays it on the payment window.
    • Users scan QR code with WeChat APP then proceed with authorization
    • When authentication is completed, Pay-Story sends authorization result data to the merchant(returnUrl).

• HashData configuration

  🔒 When requesting authentication, payment, or cancellation, the integrity of the request data is verified using
  encrypted hashdata.

• Requirement

  • Merchant Key Setting

    • The Merchant Key is a value that functions as a password for payment use and is allocated for each MID (Merchant ID).
    • "How to find the merchant key" : After accessing Paystory Merchant Admin (https://mms.minglepay.co.kr),
      merchant key information is found on the menu “[Account Management]▶[Payment Configuration]▶[KEY Information]”
    • ❗ $\textcolor{red}{\textsf{Please be careful not to disclose the key information to the outside.}}$

  • Form Data setting for Payment request

    • Please set the name attribute in the input tag (used when executing payment request script).
    • Please set the field names with accurate case sensitivity.
    • Please set all fields to "hidden" except for cases where the user needs to change them.
    • Set the action attribute of the form tag to redirect to the Authorization request page after authentication is completed.

  • Include JavaScript for calling payment window

    • Include the JS File(https://pg.minglepay.co.kr/js/pgAsistant.js) provided by Pay-Story.
      ⚠ If you download and use the JS file, payment may not be processed.
    • To call the payment window and submit after authentication, you must use two functions(SendPay() & pay_result_submit()) defined in the JS file.

<script type="text/javascript">
// function for calling payment window 
	function doPaySubmit(){
		SendPay(document.formID);  
	}
//  Function for payment Result (❌Do not modify function name )
	function pay_result_submit(){
		payResultSubmit()
	}

</script> 

• 📌 Use the sendPay() function defined in the Pay-Story JS file (https://pg.minglepay.co.kr/js/pgAsistant.js) to send the payment request data (FormData) and call the payment window.

• 📌 When Payment is complete, pay_result_submit() is called by the included JS file.
  • 👉 pay_result_submit() send the payment result data to the URL set in returnUrl parameter.