Get List of Product

POSThttps://<merchant_base_url>/product

This API is used by DANA to query the product and sync the product availability status from merchant.

API Type

DANA Open API

Expected Timeout

10 seconds 15 seconds This expected timeout is Configurable based on discussion with Aggregator

SNAP Service Code

-

Accept

application/json

Content Type

application/json

This API is used for the following solution:

Digital Goods

Digital Goods are enables partners to provide digital products within the DANA system, from publishing and synchronizing product catalogs, validating customer information, creating transactions, to tracking order status.

---

HTTP Response Code

This API must return one of these HTTP response status for the following case:

Response Code	Body	Description
200	OK	Success
400	Bad request	Empty mandatory or illegal parameter(s)
401	Unauthorized	Invalid authentication

---

version

string

1 - 8 charactersRequired

API version. As per the respective API reference

function

string

1 - 128 charactersRequired

According to specifications defined by each business domain
Value: dana.digital.goods.product.query

reqTime

string

25 charactersRequired

Request time, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)

reqMsgId

string

1 - 64 charactersRequired

Identify an unique system request. Each request will be assigned with a unique identifier (UUID)

---

type

string

1 - 32 charactersRequired

Product type specified by DANA, e.g., MOBILE_CREDIT and MOBILE_DATA.
Refer to Biz Type List

provider

string

1 - 32 charactersConditional

Product provider, e.g., telkomsel, indosat.
Refer to Provider List

Conditional Info

Y:= Type is not WATER, EDUCATION, and INTERNET

1. Request Sample for all type

{
  "request":{
    "head":{
      "version":"2.0",
      "function":"dana.digital.goods.product.query",
      "reqTime":"2018-07-04T12:08:56+07:00",
      "reqMsgId":"1234567asdfasdf1123fd123123aasd123"
    },
    "body":{
      "type":"MOBILE_CREDIT",
      "provider":"telkomsel"
    }
  },
  "signature":"signature string"
}

---

version

string

1 - 8 charactersRequired

API version. As per the respective API reference

function

string

1 - 128 charactersRequired

According to specifications defined by each business domain
Value: dana.digital.goods.product.query

respTime

string

25 charactersRequired

Response time, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)

reqMsgId

string

1 - 64 charactersRequired

Identify an unique system request. Each request will be assigned with a unique identifier (UUID)

---

products

array of json object

Required

Define the detail of product, refer to product

productId

string

1 - 64 charactersRequired

Merchant’s product identifier

type

string

1 - 32 charactersRequired

Product type specified by DANA, e.g., MOBILE_CREDIT and MOBILE_DATA.
Refer to Biz Type List on request section

provider

string

1 - 32 charactersRequired

Product provider, e.g., telkomsel, indosat.
Refer to Provider List on request section

price

money

Required

Merchant's selling price. Contains:
1. Value: Amount
2. Currency: Currency code based on ISO

value

string

1 - 19 charactersRequired

Value of amount. Need to provide the amount in the smallest common currency unit. For most, this is the amount in cents (or pence, or similarly named unit).
For example: To create a charge for $1.00, set amount=100 (100 cents)

currency

string

1 - 3 charactersRequired

Currency

availability

boolean

Required

Product availability from merchant.
This field will used to update merchant product's availability status in DANA

{
  "response":{
    "head":{
      "version":"2.0",
      "function":"dana.digital.goods.product.query",
      "respTime":"2018-07-04T12:08:56+07:00",
      "reqMsgId":"1234567asdfasdf1123fd123123aasd123"
    },
    "body":{
      "products":[
      {
        "productId":"123",
        "type":"MOBILE_CREDIT",
        "provider":"telkomsel",
        "price":{
          "value":"9700000",
          "currency":"IDR"
        },
        "availability":true
      },
      {
        "productId":"124",
        "type":"MOBILE_CREDIT",
        "provider":"telkomsel",
        "price":{
          "value":"14500000",
          "currency":"IDR"
        },
        "availability":false
      },
      {
        "productId":"125",
        "type":"MOBILE_CREDIT",
        "provider":"telkomsel",
        "price":{
          "value":"20000000",
          "currency":"IDR"
        },
        "availability":true
      }
      ]
    }
    },
  "signature":"signature string"
}