Skip to main content
You must test your code, and Bango must certify your test results, before you can go live. All development and most testing uses test credentials, which Bango supplies to you when you sign up. These credentials let you use the full capabilities of the Bango Reseller API, with production URLs, but sandboxed to ensure you and your test users can’t accidentally work with live merchants and live services. Bango recommends two stages of testing:
  1. API testing: with test credentials, making sure your code sends correctly formatted API requests, and handles responses appropriately
  2. Production testing: real-world testing with production credentials and live merchants
Certification Process Prerequisites
  1. Valid Bango Resale API username and password for a Bango test account
  2. IP addresses for the reseller systems provided and whitelisted on Bango system
  3. Basic Authentication

​
Bango Music

Bango Music is a test merchant provided by Bango which simulates a merchant. Bango Music can be used to test against the Bango platform without a live merchant connection. For all certification tests, the following API parameters should be used:
  1. productKey: BangoMusic
  2. merchantAccountKey: BANGO (case sensitive)
Before commencing with the testing, the reseller can use the Service Availability API to ensure basic network connection is working correctly.
1

Connectivity Test

Prerequisites: Refer ‘Certification Process Prerequisites’Action: Using the Bango Resale method to send a service availability request; https://resale.api.bango.net/v1/echo/[echoRequestId]Expected Result: HTTP 200

​
Certification

Successful First Time Activation These steps will certify the reseller can create a pending entitlement for the first time and activate the entitlement. The reseller will certify they can query and cancel an entitlement using the below steps.
1

Create Entitlement

Prerequisites: N/AAction: Using the Bango Resale method to create a new entitlement with appropriate parameters for your integration: 1. customerIdentifier 2. merchantAccountKey 3. productKey 4. notificationUrlExpected Result: HTTP 202
2

Query Entitlement

Prerequisites: Entitlement created successfully in action 1Action: Using the Bango Resale method to query an entitlement. https://resale.api.bango.net/v1/entitlement/[entitlementId]Expected Result: HTTP 200
3

Navigate to URL

Prerequisites: Entitlement created successfully in action 1Action: Click ‘Activate Subscription ButtonExpected Result: Presented with “Premium – Buy now with 1 click!” option. Do not click the button, the presentation of this pages means the entitlement is now active. Activation notification should have been received.
4

Query Entitlement

Prerequisites: Entitlement activated successfully in action 3Action: Using the Bango Resale method to query the entitlement from action 1. https://resale.api.bango.net/v1/entitlement/[entitlementId]Expected Result: HTTP 200
5

Cancelling an Entitlement

Prerequisites: Entitlement activated successfully in action 3Action: Using the Bango Resale method to cancel an entitlement with appropriate parameters for your integration. 1. cancelReasonCategory 2. cancelReasonCode 3. cancelReasonDescription https://resale.api.bango.net/v1/entitlement/cancel/[entitlementId]Expected Result: HTTP 200
6

Query Entitlement

Prerequisites: Entitlement cancelled successfully in action 5Action: Using the Bango Resale method to query the entitlement from action 1. https://resale.api.bango.net/v1/entitlement/[entitlementId]Expected Result: HTTP 200

​
Double Activation

The double activation certification is to check the reseller can not activate the same entitlement twice. This is completed by requesting a second entitlement using the same parameters as the first. This reseller will also revoke the entitlement.
1

Create Entitlement

Prerequisites: N/AAction: Using the Bango Resale method to create a new entitlement with appropriate parameters for your integration: 1. customerIdentifier 2. merchantAccountKey 3. productKey 4. notificationUrlExpected Result: HTTP 202
2

Navigate to URL

Prerequisites: Entitlement created successfully in action 7Action: Click ‘Activate Subscription ButtonExpected Result: Presented with “Premium – Buy now with 1 click!” option. Do not click the button, the presentation of this pages means the entitlement is now active. Activation notification should have been received.
3

Create Entitlement

Prerequisites: Entitlement created successfully in action 7Action: Using the Bango Resale method to create a new entitlement with the same parameters as action 7.Expected Result: HTTP 400
4

Query Entitlement

Prerequisites: Entitlement activated successfully in action 7Action: Using the Bango Resale method to query the entitlement from action 7. https://resale.api.bango.net/v1/entitlement/[entitlementId]Expected Result: HTTP 200
5

Revoking an Entitlement

Prerequisites: Entitlement activated successfully in action 7Action: Using the Bango Resale method to revoke an entitlement with appropriate parameters for your integration. 1. cancelReasonCategory 2. cancelReasonCode 3. cancelReasonDescription https://resale.api.bango.net/v1/entitlement/revoke/[entitlementId]Expected Result: HTTP 200
6

Query Entitlement

Prerequisites: Entitlement revoked successfully in action 11Action: Using the Bango Resale method to query the entitlement from action 7. https://resale.api.bango.net/v1/entitlement/[entitlementId]Expected Result: HTTP 200

​
Expiry and Renewals

The reseller will set an expiry date, a notification URL to certify the auto expiry and reseller notification to certify the reseller can consume a cancel notification from Bango. This step will also certify the reseller can request entitlement updates.
1

Create Entitlement

Prerequisites: N/AAction: Using the Bango Resale method to create a new entitlement with appropriate parameters for your integration: 1. customerIdentifier 2. merchantAccountKey 3. productKey 4. notificationUrl 5. dateExpiryExpected Result: HTTP 202
2

Navigate to URL

Prerequisites: Entitlement created successfully in action 13Action: Click ‘Activate Subscription ButtonExpected Result: Presented with “Premium – Buy now with 1 click!” option. Do not click the button, the presentation of this pages means the entitlement is now active. Activation notification should have been received.
3

Update Entitlement

Prerequisites: Entitlement activated successfully in action 13Action: Using the Bango Resale method to update an entitlement with a new expiry time close to the time now. 1. entitlementId 2. dateExpiryExpected Result: HTTP 200
4

Query Entitlement

Prerequisites: Entitlement created successfully in step 13Action: Using the Bango Resale method to query an entitlement. Once the time has passed on the expiry date and time set in step 15. Query the entitlement using the entitlement ID provided in action 13. https://resale.api.bango.net/v1/entitlement/[entitlementId]Expected Result: HTTP 200
For more information, contact Bango Support.