Direct carrier billing — Payment acceptance via the YooMoney API

Direct carrier billing

Specifics

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

Integration scenarios

Ready-made solutions: Smart payment

Manual integration: Payment via direct carrier billing

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
PHP
Python
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

JSON
{
  "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