Direction

Huawei IAP server -> Developer server

URL

The URL is configured when you apply for the HUAWEI IAP service.

Data Format

Request: Content-Type: application/json

Response: Content-Type: application/json

statusUpdateNotification

M

String

Notification message, which is a JSON   string. For details, please refer to the description of Table statusUpdateNotification.

notifycationSignature

M

String

Signature string for the statusUpdateNotification parameter.   The signature algorithm is SHA256withRSA.

After receiving the signature string,   your server needs to use the payment public key to verify the JSON string of   the statusUpdateNotification   parameter. 

For details, please refer to Verifying the Signature in the   Returned Result.

For details about how to obtain the public key, please refer to Querying IAP Information.

environment

M

String

Environment for sending a notification.

• PROD: official environment

• SandBox: sandbox testing environment

notificationType

M

Integer

Notification event type. For details, please refer to the notificationType table.

subscriptionId

M

String

Subscription ID.

cancellationDate

O

Long

Timestamp, which is passed only when notificationType is set to CANCEL(1).

orderId

M

String

Order ID used for payment during   subscription renewal.

latestReceipt

O

String

Token of the latest receipt, which is   passed only when notificationType   is set to INITIAL_BUY(0), RENEWAL(2), or INTERACTIVE_RENEWAL(3) and the renewal is successful.

latestReceiptInfo

O

String

Latest receipt, which is a JSON string.   This parameter is left empty when notificationType   is set to CANCEL(1). For details   about the parameters contained, please refer to the description of  InAppPurchaseDetails.

latestReceiptInfoSignature

O

String

Signature string for the latestReceiptInfo parameter. The   signature algorithm is SHA256withRSA.

After receiving the signature string,   your server needs to use the payment public key to verify the JSON string of   the latestReceiptInfo parameter.   

For details, please refer to Verifying the Signature in the Returned Result.

For details about how to obtain the   public key, please refer to Querying IAP Information.

latestExpiredReceipt

O

String

Token of the latest expired receipt. This   parameter has a value only when notificationType   is set to RENEWAL(2) or INTERACTIVE_RENEWAL(3).

latestExpiredReceiptInfo

O

String

Latest expired receipt, which is a JSON   string. This parameter has a value only when notificationType is set to RENEWAL(2)   or INTERACTIVE_RENEWAL(3).

latestExpiredReceiptInfoSignature

O

String

Signature string for the latestExpiredReceiptInfo parameter.   The signature algorithm is SHA256withRSA.

After receiving the signature string,   your server needs to use the payment public key to verify the JSON string of   the latestExpiredReceiptInfo   parameter. 

For details, please refer to Verifying the Signature in the   Returned Result.

For details about how to obtain the   public key, please refer to Querying IAP Information.

autoRenewStatus

M

Integer

Renewal status.

• 1: The subscription renewal is normal.

• 0: The user cancels subscription   renewal.

refundPayOrderId

O

String

Refund order ID. This parameter has a   value only when notificationType  is set to CANCEL(1).

productId

M

String

In-app product ID.

applicationId

O

Long

App ID.

expirationIntent

O

Integer

Expiration reason. This parameter has a   value only when notificationType  is set to RENEWAL(2) or INTERACTIVE_RENEWAL(3) and the   renewal is successful.

INITIAL_BUY(0)

Integer. First purchase behavior of a subscription.

CANCEL(1)

Integer. When customer service personnel or an app cancels a subscription, the cancellation time (when the refund starts) can be obtained using cancellationDate.

RENEWAL(2)

Integer. When an expired subscription is automatically renewed, the next renewal time can be obtained based on the expiration time in the receipt.

INTERACTIVE_RENEWAL(3)

Integer. When a user renews an expired subscription or switches from an expired subscription to another one, the service takes effect immediately after the operation is successful.

NEW_RENEWAL_PREF(4)

Integer. A user selects another subscription in a group and it takes effect after the current subscription expires. The subscription validity period is not affected. That is, the subscription takes effect in the next validity period after downgrade or crossgrade.

The notification carries the last valid receipt and new subscription information, including the product ID and subscription ID.

RENEWAL_STOPPED(5)

Integer. The renewal of a subscription is stopped by a user, a developer, or Huawei, but the paid service of the subscription is still valid. The notification contains the latest receipt, product ID, app ID, subscription ID, and subscription token.

RENEWAL_RESTORED(6)

Integer. A user renews a subscription and the renewal status is normal. The notification contains the latest receipt, product ID, app ID, subscription ID, and subscription token.

RENEWAL_RECURRING(7)

Integer. One-time renewal fees are successfully deducted in the promotion period, free trial period, and sandbox testing. The notification contains the latest receipt, product ID, app ID, subscription ID, and subscription token.

IN_GRACE_PERIOD(8)

Integer. The subscription expires but the grace period is enabled.

ON_HOLD(9)

Integer. An expired subscription enters the account retention period.

PAUSED(10)

Integer. After a user makes a renewal suspension plan, the subscription enters the paused state when its validity period ends.

PAUSE_PLAN_CHANGED(11)

Integer. A user has made a renewal suspension plan.

PRICE_CHANGE_CONFIRMED(12)

Integer. A user agreed to the price increase.

DEFERRED(13)

Integer. The subscription renewal time has been postponed.

errorCode

O

String

Processing failure result code. The   result code is defined by a developer.

errorMsg

O

String

Failure cause description.