PFI (PayForIt)/Carrier payment is a direct method to get fast payments via mobile carrier. All subscriber acquisition and billing is done by the DCB provider.

User Flow

1. Call the 'https://gateway.mobivate.com/api/dcb/init
2. method via S2S POST request.
3. Get the PFI-URL as response from /api/dcb/init request.
4. Redirect users browser to the PFI-URL received

Depending on if the user is connected to 3G/4G or WiFi one of the two flows will occur. (see example images below)

Initiate Request

POST https://gateway.mobivate.com/api/dcb/init
DATA: account_id=<account_id>&api_key=<api_key>&source=<shortcode>&service_id=<service_id>&return=https://<clients site>¬ification=http://<clients s2s endpoint>

Upon successful call you will get http 200 response with url that the visitor should be redirected to.

Parameters

Notifications

You also need to implement the API where HTTP POSTs would be sent whenever there is a successful billing on the subscriber. It is a standard HTTP form post, that contains parameters:

First screen the user will see when you redirect them to the HTTP URL received is:

If the user accepts, the next screen will be:

And if the user accepts again, he will get subscribed and the next screen will be:

First screen the user will see when you redirect them to the HTTP URL received is:

When the user enters his or her mobile number, the next screen will ask them to confirm a PIN message

At the same time the user will receive the following message:

It is also possible to programmaticaly unsubscribe from the list.

use endpoint https://gateway.mobivate.com/pfi/unsubscribe/ using POST params:

If you have successfully unsubscribed the user the response will be:

{“ok”:true}

If the request was unsuccessful then you will receive:

{“ok”:false}