- Payment method type in the API: mobile_balance
- Confirmation scenario: External
- Payment term: 1 hour
- Holding: 6 hours
- Code in reports: MC
- Refund: yes, only full
- Refund processing time: instantly
- Recurring payments: no
- Limits: the minimum payment amount is 10 rubles, and the maximum amount can be from 5,000 to 15,000 rubles (it depends on the mobile carrier), there are additional restrictions
- Supported mobile carriers: Megafon, Beeline, MTS, Tele2
Ready-made solutions: Smart payment
Manual integration: Payment via direct carrier billing
Step 1. Create a payment with the
mobile_balance
type as well as the user’s phone number for making the payment in the payment_method_data
object, and the external
type in the confirmation
object.Example of request
curl https://api.yookassa.ru/v3/payments \ -X POST \ -u <Shop ID>:<Secret Key> \ -H 'Idempotence-Key: <Idempotence Key>' \ -H 'Content-Type: application/json' \ -d '{ "amount": { "value": "2.00", "currency": "RUB" }, "payment_method_data": { "type": "mobile_balance", "phone": "79000000000" }, "confirmation": { "type": "external" }, "description": "Order No. 72" }'
Example of a created payment object
{ "id": "22c80e01-000f-5000-a000-14ce15eb7b74", "status": "pending", "paid": false, "amount": { "value": "2.00", "currency": "RUB" }, "confirmation": { "type": "external" }, "created_at": "2018-06-29T09:22:09.367Z", "description": "Order No. 72", "metadata": {}, "payment_method": { "type": "mobile_balance", "id": "22c80e01-000f-5000-a000-14ce15eb7b74", "saved": false }, "recipient": { "account_id": "100500", "gateway_id": "100700" }, "refundable": false, "test": false }
Step 2. Inform the user that they need to confirm the payment.
Step 3. Wait for the payment to be successfully completed: you will receive a notification from YooMoney, or you can send periodic requests for payment information .
Do you have any questions or comments regarding the documentation?
We can set up a call and discuss them: we'll help you solve the problem and you'll help us understand what we need to improve. To do that, share your contact information and select the time.
Yes, I'd like to set up a meeting