Bango uses cookies to give you the best website experience. By using this website you agree to let Bango use cookies. More info
OK
Bango Developer
  1. Bango Resale
  2. For resellers
  3. Product API reference
  4. Product selection API

Product selection API

Details of the API for selecting a users product

This page describes the method used to select a product for a reseller customer.

Every API request must comply with the requirements in Bango Platform / Connectivity and security. All request body parameters and responses are encoded as UTF-8 JSON objects.

Selecting a product

POST https://a.bango.net/reseller/{resellerIdentifier}/products
Path parameters
resellerIdentifier string

A unique identifier for the reseller.

Header parameters
Authorization string

Your Bango Resale API credentials encoded for HTTP Basic Authentication. See Bango Platform / Connectivity and security / Basic authentication.

X-RequestIdentifier string

A unique identifier for the request. If present, this ID is used for Bango Platform idempotency.

X-CustomerIdentifier string

Customer unique identifier for the reseller.

Query parametersNone
Body parameters
productIdentifier string

Assigned productIdentifier reference.

productRank

Reseller preferred rank of this offer (0 is highest).

productStatus string

Status of the product with reseller. Supported values are ACTIVE, SELECTED, NONE).

productName string

Display name for this productIdentifier.

productDescription string

Display description for this productIdentifier.

productLogoURL string

URL to display logo for this productIdentifier.

productTermsURL string

URL to display Terms and Conditions for this productIdentifier.

productPrice string

Display price as a string for this productIdentifier.

productOfferType string

Display type of reseller offer for this productIdentifier.

productActivationUrl object

Activation Url provided by the merchant for customer sign-up.

Sample requests
Select eligible product for this reseller's customer
POST https://a.bango.net/reseller/ResellerABC/products HTTP/1.1

{
    "productIdentifier": "string",
    "productRank": 0,
    "productStatus": "string",
    "productName": "string",
    "productDescription": "string",
    "productLogoURL": "string",
    "productTermsURL": "string",
    "productPrice": "string",
    "productOfferType": "string",
    "productActivationUrl": "string"
}
Response body
responseCode string

Result of the request. Possible values: OK, CLIENT_ACTION_REQUIRED, BAD_REQUEST, UNAUTHORIZED, NOT_AVAILABLE, ALREADY_EXISTS, TOO_MANY_REQUESTS, INTERNAL_ERROR, SERVICE_UNAVAILABLE. See sample responses for more information.

responseMessage string

A short human-readable message describing responseCode. Not for use by code.

productActivationURL object2xx

Product activation URL for this customer.

Sample responses
200OKProduct selected successfully
{
    "responseCode": "string",
    "responseMessage": "string",
    "productActivationURL": "string"
  }

400BAD_REQUESTInvalid API request
{
    "responseCode": "BAD_REQUEST",
    "responseMessage": "Invalid request."
}

The Bango Platform was unable to process the request. This indicates an implementation problem in your code. Check your productKey and notificationUrl are correct.

401UNAUTHORIZEDIP address or access credentials are invalid
{
    "responseCode": "UNAUTHORIZED",
    "responseMessage": "You have not provided adequate credentials to access this resource."
}

The Bango Platform didn't process the request as the supplied credentials were invalid, or the request was not from an authorized IP address. This indicates an implementation problem in your code or a configuration issue. See Bango Platform / Connectivity and security / Basic authentication and Bango Platform / Connectivity and security / IP whitelisting.

404NOT_AVAILABLEUnable to find customer
{
    "responseCode": "NOT_FOUND",
    "responseMessage": "Customer not found"
}
429TOO_MANY_REQUESTSRequest limit reached
{
    "responseCode": "TOO_MANY_REQUESTS",
    "responseMessage": "Request limit reached. Please try again later"
}

The Bango Platform didn't process the request as you've sent too many requests recently. Try again later.

500INTERNAL_ERRORUnexpected server issue
{
    "responseCode": "INTERNAL_ERROR",
    "responseMessage": "The server encountered an unexpected condition."
}

The Bango Platform couldn't respond to the request. Try again later.

502UNEXPECTED_ERRORBango Platform undergoing maintenance
{
    "responseCode": "UNEXPECTED_ERROR",
    "responseMessage": "An unexpected error has occurred."
}
503SERVICE_UNAVAILABLEBango Platform undergoing maintenance
{
    "responseCode": "SERVICE_UNAVAILABLE",
    "responseMessage": "The server is undergoing maintenance."
}

The Bango Platform is undergoing maintenance and is not currently available. Try again later.

Copyright © 2000–2020 Bango.net Limited