-
Notifications
You must be signed in to change notification settings - Fork 5
Payments: async notification
On top of the synchronous response, EIP681A payments provides an asynchronous notification service allow you to sync AppCoins transactions with your own servers. The EIP681A notification service triggers a notification when a completed, canceled or failed event occurs. In order to use this service you must set the callback_url parameter at the EIP681A URI and prepare your server to receive a sign transaction resource as described bellow.
POST
https://www.mygamestudio.com/v1/appcoins_ipn.php?out_trade_no=2082389608326064
| Type | Name | Description | Schema | Example |
|---|---|---|---|---|
| Body | signature | Notification signature based on transaction parameter | string | "0x7b87a3c4dd63bee43d4c88" |
| Body | transaction | Transaction resource in json | string |
This parameter represents a transaction resource under a json string schema. This data is used to generate the signature parameter that we recommend to be validated as described on the 'Validate transaction resource' section.
{"uid":"ApGuj5aRILeWka8P","domain":"com.mygamestudio.game","product":"sword.001","status":"COMPLETED","added":"2018-11-0211:24:31.815136","modified":"2018-11-0211:26:46.043137","price":{"appc":"1","currency":"USD","value":"0.1"}}
| Name | Description | Schema | Example |
|---|---|---|---|
| uid | Unique ID for transaction resource | string | "ApGuj5aRILeWka8P" |
| domain | Package name | string | "com.mygamestudio.game" |
| product | Product name (aka sku) | string | "sword.001" |
| status | Transaction status | string | "COMPLETED" or "CANCELED" or "FAILED" |
| added | Transaction added timestmap | string | "2018-11-02 11:24:31.815136" |
| modified | Transaction modified timestmap | string | "2018-11-02 11:26:46.043137" |
| price.appc | Transaction price in AppCoins | string | "1" |
| price.currency | Transaction price currency | string | "USD" |
| price.value | Transaction price value | string | "0.1" |
The transaction resource is signed with your wallet private key. In order to validate if the signature parameter match to the transaction parameter, one of the following examples can be used:
- (PHP) PHP validation
- (JS / Node) Javascript validation