Mobiamo In-App Payments (SDK)
Please use Mobiamo Android SDK, which is the SDK wrapper for this API.
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 email@example.com
This API powers steps 2 and 3 on the payment flow below.
Initializing a payment
|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|
|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:
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.
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.