Prerequisites

For Android in-app purchases to be connected to Cleeng's system, the following steps must be completed:

In order to validate Android receipt, Cleeng requires Android OAuth Client ID in JSON format. The Client ID should be created with permission to use google API’s on behalf end user, with privileges to view finance reports.

Product ID (SKU) should be the reference of Cleeng Offer ID but must be composed of only lowercase letters (a-z).

For example:

To process receipt validation App or Middleware has to send POST request in JSON format with authorization credentials to Cleeng after successful purchase on Google Play service. The request has to contain Customer Token, Offer ID and Receipt object that should be taken from Google Play Purchase object that is passed back to the listener after purchase.

Contact us to finalize Android in-app purchase setup.

Purchase Flow

The Android app is responsible for displaying the “buy" button to initiate the payment. Once successful payment is completed through Android Billing, the Cleeng receipt endpoint must be notified.

Receipt Endpoint

📘

Production URL: https://cleeng.com/android/payment
Sandbox URL: http://sandbox.cleeng.com/android/payment

Request

1. Request method: POST
2. Required headers:

Content-Type: application/json
X-Publisher-Token: publisher_token

3. Json payload example

{
  "customerEmail": "[email protected]",
  "offerId": "S598742062_US",
  "receipt": {
    "productId": "s598742062_us",
    "purchaseToken": "rojeslcdyyiapnqcynkjyyjh",
    "packageName": "com.cleeng.iap.android.demo",
    "orderId": "n9lGZjAWtRNhc98",
    "purchaseState": "0",
    "purchaseTime": "1495672338713",
    "developerPayload": "39772f248878a8ff130c0b167caa45e7"
  },
  "ipAddress": "192.168.1.1"
}

4. Available Parameters

5. Example Response,

{
  "message": "OK"
}

6. Response Description

message - Processing result

7. Error Codes

Validate Access

In order to register a transaction in Cleeng, the receipt data returned from Android Billing must be passed to the secure Cleeng endpoint for validation. The endpoint accepts a POST request of a JSON payload.

Payment processing is an asynchronous process. Even that most responses are within 4 seconds, it can take up to 30 seconds. Our recommendation is that the application polls the Cleeng API using the getAccessStatus() or getAccessibleTags() method until the transaction is completed and access is granted.
The below flowchart shows the process: