API INTEGRATION. Onebip Mobile Payment System

4. API integration

Onebip provides with the opportunity to have the additional features that will allow you to manage the operations of unsubscription and black-lists.

4.1 Unsubscription API

You can change the state of a subscription from ACTIVE to TERMINATED using a specific Onebip Unsubscription API.

The method will be the following:

DELETE

/api/subscription/<ID>

Where <ID> is the subscription_id created by Onebip at the act of first subscription.

You will be allowed to use this action only with the authentication by using your username and password that you created during your registration process of Onebip.

An example, using curl, can be seen in the following box: curl -u [email protected]:m3rc4nt123 -X DELETE http://www.onebip.com/api/subscription/ 291dd69cr4ee4aa3f1d3rt85

Onebip expects to receive a response with::



HEADER:



BODY:

200 OK empty

4.2 Blacklist API

With blacklist API you can decide to

“blacklist” an MSISDN or a Onebip user who may have one or more MSISDNs associated to her Onebip account, which has performed at least one one-time or subscription-based transaction towards for one of your services.

On one hand, t his means that the blacklisted user won’t be able to complete any other transactions for any of your services in future. On the other hand, with a similar operation you can also “un-blacklist” the MSISDNs or the users which you have blacklisted before in order to allow them to make transactions again for your services.

4.2.1. Constructing a blacklist requests

You can request a blacklist operation using a HTTP POST method towards the url:

http(s)://www.onebip.com/api/blacklist

You will be allowed to use this action only with the authentication by using your username and password that you created during your registration process of Onebip.

30

Integration Guide 4.0