> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19/undefined-6/api-v6/pns.md).

# PNS 메시지 상세 변경 내역

### **메시지 포멧 변경 내역**  <a href="#pns" id="pns"></a>

* 원화 외의 통화를 지원하기 위하여 결제금액(price)의 데이터 타입이 Number에서 String으로 변경하였습니다.
* 원화 외의 통화를 지원하기 위하여 결제금액의 통화코드(priceCurrencyCode)를 추가하였습니다.
* 원화 외의 통화를 지원하기 위하여 결제수단별금액(amount)의 데이터 타입이 Number에서 String으로 변경하였습니다.
* 응답 규격에 purchaseToken, environment, marketCode 필드가 추가되었습니다.

**Request Body : JSON 형식**

| Element Name       | Data Type     | Data Size   | Required    | Description                                                            |                                       |
| ------------------ | ------------- | ----------- | ----------- | ---------------------------------------------------------------------- | ------------------------------------- |
| msgVersion         | String        | -           | true        | <ul><li>개발(Sandbox) : 3.0.0D</li><li>상용(상용테스트) : 3.0.0</li></ul>       |                                       |
| packageName        | String        | <p><br></p> | true        | 앱의 패키지 네임                                                              |                                       |
| productId          | String        | <p><br></p> | true        | 인앱상품의 상품 ID                                                            |                                       |
| messageType        | String        | <p><br></p> | true        | SINGLE\_PAYMENT\_TRANSACTION 고정                                        |                                       |
| purchaseId         | String        | <p><br></p> | true        | 구매 ID                                                                  |                                       |
| developerPayload   | String        | <p><br></p> | false       | 구매건을 식별하기 위해 개발사에서 관리하는 식별자                                            |                                       |
| purchaseTimeMillis | Long          | <p><br></p> | true        | 원스토어 결제 시스템에서 결제가 완료된 시간(ms)                                           |                                       |
| purcahseState      | String        | <p><br></p> | true        | COMPLETED : 결제완료 / CANCELED : 취소                                       |                                       |
| price              | String        | <p><br></p> | true        | 결제 금액                                                                  |                                       |
| priceCurrencyCode  | String        | <p><br></p> | true        | 결제 금액 통화코드(KRW, USD, ...)                                              |                                       |
| productName        | String        | <p><br></p> | false       | 구매요청 시 개발사가 customized 인앱상품 제목을 설정한 경우 전달                              |                                       |
| paymentTypeList    | List          | <p><br></p> | true        | 결제 정보 목록                                                               |                                       |
| <p><br></p>        | paymentMethod | String      | <p><br></p> | true                                                                   | 결제 수단 (상세 내용은 아래 paymentMethod 정의 참고) |
| <p><br></p>        | amount        | String      | <p><br></p> | true                                                                   | 결제 수단 별 금액                            |
| billingKey         | String        | <p><br></p> | true        | 확장 기능용 결제 키                                                            |                                       |
| isTestMdn          | Boolean       | <p><br></p> | true        | 시험폰 여부(true : 시험폰, false : 시험폰 아님)                                     |                                       |
| purchaseToken      | String        | <p><br></p> | true        | 구매토큰                                                                   |                                       |
| environment        | String        | <p><br></p> | true        | <p>결제환경</p><ul><li>개발(샌드박스) : SANDBOX</li><li>상용 :COMMERCIAL</li></ul> |                                       |
| marketCode         | String        | <p><br></p> | true        | 마켓 구분코드 (MKT\_ONE : 원스토어)                                              |                                       |
| signature          | String        | <p><br></p> | true        | 본 메시지에 대한 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" "ajkfl;askfjkladfjksl"
}
```

<br>

<br>
