YooMoney API
Old versions of the API
Sign up for YooMoney
Processing a payment via mobile SDKs
If you are using the YooMoney’s mobile SDKs, you will need to exchange payment data for a one-time payment token in the SDK, then include this token in the payment creation request to the API.
Payments with tokens
Step 1. Get the payment token in iOS or Android SDK. It will contain the selected payment method, payment details, and information about payment confirmation scenarios.
Step 2. Send the token to your server.
Step 3. Create a payment  and use the payment token in the payment_token parameter.
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 '{
        "payment_token": "pt-28cd3959-0000-500c-a000-03b4de9b24a7",
        "amount": {
          "value": "2.00",
          "currency": "RUB"
        "capture": false,
        "description": "Order No. 72"
Step 4. If the payment status is pending, redirect the user to confirmation_url.
Example of a created payment object
  "id": "23d93cac-000f-5000-8000-126628f15141",
  "status": "pending",
  "paid": false,
  "amount": {
    "value": "2.00",
    "currency": "RUB"
  "confirmation": {
    "type": "redirect",
    "confirmation_url": "<Link for 3-D Secure authentication>"
  "created_at": "2019-01-22T14:30:45.129Z",
  "description": "Order No. 72",
  "metadata": {},
  "recipient": {
    "account_id": "100500",
    "gateway_id": "100700"
  "refundable": false,
  "test": false
Step 5. Wait for the payment to be successfully completed: you will receive a notification from YooMoney, or you can send periodic requests for payment information .
See also