使用PNS(Push Notification Service)

ONE store為開發者提供兩種Push Notification Service。

• 第一種是PNS(Payment Notification Service，支付通知服務)，當發生In-App商品支付或取消支付時，ONE store向開發公司伺服器發送通知。

• 第二種是SNS（Subscription Notifacation Service，訂閱通知服務），在訂閱狀態發生變化時向開發公司伺服器發送通知。

設置PNS接收伺服器URL

您可以通過點擊"開發者中心>Apps>App商品選擇>In-App資訊"選單中的"管理PNS"按鈕來設置接收PNS的開發公司伺服器的URL。

URL可以分別設置Sandbox(開發用)支付環境和商用(包括商用测试)支付環境，如果開發用/商用伺服器相同，則輸入相同的URL即可。

PNS詳細資訊

Payment Notification消息發送規格(ONE store→開發公司伺服器)

• URI : 在開發者中心設置的 Payment Notification URL

• Method : POST

• Request Parameters : N/A

• Request Header

  Parameter Name

  Data Type

  Description

  Content-Type

  String

  application/json

• Request Body : JSON格式

  Element Name

  Data Type

  Description

  msgVersion

  String

  消息版本

  • 開發(Sandbox) : 3.0.0D

  • 商用(商用測試) : 3.0.0

  packageName

  String

  應用軟件的包名

  productId

  String

  In-App商品的商品ID

  messageType

  String

  SINGLE_PAYMENT_TRANSACTION 固定

  purchaseId

  String

  購買ID

  developerPayload

  String

  由開發公司管理以標示購買件的標示符

  purchaseTimeMillis

  Long

  在ONE store支付系统中完成支付的時間(ms)

  purcahseState

  String

  COMPLETED : 已支付 / CANCELED : 取消

  price

  String

  支付金額

  priceCurrencyCode

  String

  支付金額貨幣代碼(KRW, USD, ...)

  productName

  String

  請求購買時，如開發公司設置了customized In-App商品標題則傳達

  paymentTypeList

  List

  支付資訊列表

  paymentMethod

  String

  amount

  String

  billingKey

  String

  用於擴展的付款密鑰

  isTestMdn

  Boolean

  是否是測試機(true : 測試機, false : 非測試機)

  purchaseToken

  String

  購買token

  environment

  String

  支付環境

  • 開發(SANDBOX) : SANDBOX

  • 商用 :COMMERCIAL

  marketCode

  String

  市場分類編碼 ( MKT_ONE : ONE store, MKT_GLB : Global ONE store)

  signature

  String

  此消息的signature

• Example

{
    "msgVersion" : "3.0.0",
    "packageName":"com.onestore.pns",
    "productId":"0900001234",
    "messageType":"SINGLE_PAYMENT_TRANSACTION",
    "purchaseId":"SANDBOX3000000004564",
    "developerPayload":"OS_000211234",
    "purchaseTimeMillis":24431212233,
    "purchaseState":"COMPLETED",
    "price":"10000",
    "priceCurrencyCode":"KRW",
    "productName":"GOLD100(+20)",
    "paymentTypeList":[
        {
            "paymentMethod":"DCB",
            "amount":"3000"
        },
        {
            "paymentMethod":"ONESTORECASH",
            "amount":"7000"
        }
    ],
    "billingKey" : "36FED4C6E4AC9E29ADAF356057DB98B5CB92126B1D52E8757701E3A261AF49CCFBFC49F5FEF6E277A7A10E9076B523D839E9D84CE9225498155C5065529E22F5",
    "isTestMdn" : true,
    "purchaseToken" : "TOKEN...",
    "environment" : "SANDBOX",
    "marketCode" : "MKT_ONE",
    "signature" : "SIGNATURE..."
}

paymentMethod(ONE store支付方式)定義

Signatue驗證方法

使用下面的代碼，您可以檢查signature是否偽造。

• "代碼"中的PublicKey是指"開發者中心 > Apps > In-App資訊 > 認證與許可證"中提供的許可證密鑰。 有關許可證密鑰的詳細資訊，請參閱 "In-App支付的預準備頁面的"驗證許可證密鑰和OAuth認證資訊"部分。

<?php
function formatPublicKey($publicKey) {
 $BEGIN= "-----BEGIN PUBLIC KEY-----";
 $END = "-----END PUBLIC KEY-----";
   
 $pem = $BEGIN . "\n";
 $pem .= chunk_split($publicKey, 64, "\n");
 $pem .= $END . "\n";
   
 return $pem;
}
   
function formatSignature($signature) {
 return base64_decode(chunk_split($signature, 64, "\n"));
}
   
// Sample message
$sampleMessage = '{"msgVersion":"2.0.0.D","purchaseId":"SANDBOX3000000004564","developerPayload":"OS_000211234","packageName":"com.onestore.pns","productId":"0900001234","messageType":"SINGLE_PAYMENT_TRANSACTION","purchaseMillis":24431212233,"purchaseState":"COMPLETED","price":20000,"productName":"한글은?GOLD100(+20)","paymentTypeList":[{"paymentMethod":"DCB","amount":3000},{"paymentMethod":"ONESTORECASH","amount":7000}],"billingKey":"36FED4C6E4AC9E29ADAF356057DB98B5CB92126B1D52E8757701E3A261AF49CCFBFC49F5FEF6E277A7A10E9076B523D839E9D84CE9225498155C5065529E22F5","isTestMdn":true,"signature":"MNxIl32ws+yYWpUr7om+jail4UQxBUXdNX5yw5PJKlqW2lurfvhiqF0p4XWa+fmyV6+Ot63w763Gnx2+7Zp2Wgl73TWru5kksBjqVJ3XqyjUHDDaF80aq0KvoQdLAHfKze34cJXKR/Qu8dPHK65PDH/Vu6MvPVRB8TvCJpkQrqg="}';
   
// Sample public key
$publicKey = "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDMzpWJoK1GSOrr4juma5+sREYjdCW8/xSd9+6z6PAkUH5af97wy8ecfkLtP9LK5VskryfDlcOjfu0BgmHYntAqKT7B4KWk8jWbJ8VHUpp30H95UbcnCRFDqpEtwYzNA5gNMYKtAdbL41K8Fbum0Xqxo65pPEI4UC3MAG96O7X1WQIDAQAB";
   
   
// Parse JSON message
$jsonArr = json_decode($sampleMessage, true);
   
// Extract and remove signature
$signature = $jsonArr["signature"];
unset($jsonArr["signature"]);
$originalMessage = json_encode($jsonArr, JSON_UNESCAPED_UNICODE);
   
// Veify
$formattedKey = formatPublicKey($publicKey);
$formattedSign = formatSignature($signature);
$hash_algorithm = 'sha512';
   
$success = openssl_verify($originalMessage, $formattedSign, $formattedKey, $hash_algorithm);
if ($success == 1) {
 echo "verified";
}
else {
 echo "unverified";
}
?>php

import java.security.PublicKey;
    
import org.apache.commons.codec.binary.Base64;
import org.codehaus.jackson.JsonNode;
import org.codehaus.jackson.map.ObjectMapper;
import org.codehaus.jackson.node.ObjectNode;
    
    
public class SignatureVerifier {
    
    private static final String SIGN_ALGORITHM = "SHA512withRSA";
    private ObjectMapper mapper = new ObjectMapper();
    
    
    boolean verify(String rawMsg, PublicKey key) throws Exception {
        // JSON 메시지에서 signature를 추출한다.
        JsonNode root = mapper.readTree(rawMsg);
        String signature = root.get("signature").getValueAsText();
        ((ObjectNode)root).remove("signature");
           
        // 추출한 signature가 올바른 값인지 검증한다.
        Signature sign = Signature.getInstance(SIGN_ALGORITHM);
        sign.initVerify(key);
        sign.update(root.toString().getBytes("UTF-8"));
        return sign.verify(Base64.decodeBase64(signature));
    }
}

# -*- coding: utf-8 -*-
   
import json
from base64 import b64decode
from collections import OrderedDict
   
from Crypto.Hash import SHA512
from Crypto.PublicKey import RSA
from Crypto.Signature import PKCS1_v1_5
   
import sys
reload(sys)
sys.setdefaultencoding('utf-8')
   
hash = "SHA-512"
   
   
def verify(message, signature, pub_key):
    signer = PKCS1_v1_5.new(pub_key)
    digest = SHA512.new()
    digest.update(message)
    return signer.verify(digest, signature)
   
   
jsonData = json.loads(rawMsg, encoding='utf-8', object_pairs_hook=OrderedDict)
signature = jsonData['signature']
del jsonData['signature']
originalMessage = json.dumps(jsonData, ensure_ascii=False, encoding='utf-8', separators=(',', ':'))
   
RSA.importKey(publickey).publickey()
print(verify(originalMessage, b64decode(signature), RSA.importKey(publickey).publickey()))

Subscription Notification消息發送規格(ONE store → 開發公司伺服器)

• URI : 在開發者中心設置的Subscription Notification URL

• Method : POST

• Request Parameters : N/A

• Request Header

  Parameter Name

  Data Type

  Description

  Content-Type

  String

  application/json

• Request Body : JSON格式

  Element Name

  Data Type

  Description

  msgVersion

  String

  消息版本

  • 開發(Sandbox) : 3.0.0D

  • 商用(商用测測試) : 3.0.0

  packageName

  String

  應用軟件的包名

  eventTimeMillis

  Long

  event發生時間

  subscriptionNotification

  Object

  支付資訊目錄

  version

  String

  訂閱提醒消息版本

  notificationType

  Integer

  訂閱狀態

  purchaseToken

  String

  购买Token

  productId

  String

  In-App商品的商品ID

  environment

  String

  支付環境 · 開發(Sandbox) : SANDBOX · 商用 :COMMERCIAL

  marketCode

  String

  市場分類代碼 ( MKT_ONE : ONE store, MKT_STM : storm )

• Example

{
    "msgVersion":"3.0.0",
    "packageName":"com.onestore.pns",
    "eventTimeMillis":24431212233000,
    "subscriptionNotification": {
        "version": "1",
        "notificationType" : 1,
        "purchaseToken":"TOKEN",
        "productId": "com.product.id"
    },
    "environmenmt": "COMMERCIAL",
    "marketCode": "MKT_ONE"
}

訂閱狀態定義

Notification傳輸方法

ONE store中的PNS伺服器通過HTTP(S)請求向開發公司伺服器發送notification。

此时，開發公司伺服器应以200回應HTTP Status Code，表示已正常接收notification。

如果由於網絡延遲而丢失，或者由於開發公司伺服器的異常情况，HTTP Status Code未能以200進行回應，PNS伺服器將認為notification傳輸失敗，並在3天内最多执行30次重傳。

Notification的重傳是在具有一定delay後執行，如下例所示，當重試次數增多時，delay會逐渐增加。 Example