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, only full payment capture is available
Code in reports: MC
Refund: yes, full and partial
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, t2

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 .

Done!