Documentation
Mobiamo In-App Payments (SDK)
Please use Mobiamo Android SDK, which is the SDK wrapper for this API.
API Description
Mobiamo API allows merchants to charge users via mobile carrier billing by using Paymentwall's API and merchant's own payment forms.
This API is activated by request. To activate it please email us at devsupport@paymentwall.com
This API powers steps 2 and 3 on the payment flow below.
Payment Flow
Initializing a payment
API Endpoint
https://api.paymentwall.com/api/mobiamo/payment
Request type
POST
Protocols supported
HTTP, HTTPS
Request Parameters
| Parameter | Description |
|---|---|
| uid | ID of the end-user who's making the payment in Merchant's system |
| key | Project Key provided by Paymentwall |
| product_name | name of the product purchased by the user |
| product_id | ID of the product purchased by the user |
| amount | pricepoint amount, e.g. 9.99 |
| currency | pricepoint currency code, e.g. EUR |
| country | pricepoint country code, e.g. DE |
| mnc | Mobile Network Code, needed along with mcc to identify user's carrier and provide relevant instructions |
| mcc | Mobile Country Code |
| ts | unix timestamp when the request was initiated, in seconds |
| sign | request signature, for more details on signature calculation click here |
| sign_version | version of signature, required to be at least 2 |
Response Parameters:
| Parameter | Description |
|---|---|
| transaction_id | id of the order |
| keyword | keyword to be sent in the MO SMS message |
| shortcode | a number where the MO SMS message needs to be sent |
| regulatory_text | text, required by carriers to be shown to the user before purchasing |
Billing the user
User then needs to send an MO SMS to the given shortcode with the following text:
keyword transaction_id
If the merchant has access to sending text messages on behalf of the user, e.g. an Android Application, the message can be sent automatically.
Payment Confirmation
Once the payment is processed, Paymentwall will send a server-to-server pingback to merchant's server. The format of the pingback matches Digital Goods API.
