Перейти к содержанию

Мобильная коммерция (Mobile Commerce)

Этот платежный метод позволяет производить оплату с баланса мобильного телефона.

Вариант интеграции IS

Info

Этот вариант интеграции поддерживает только валюту KZT.

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отображает покупателю страницу для ввода номера телефона.
  3. Покупатель вводит номер телефона и инициирует продолжение оплаты.
  4. Торговец отправляет запрос оплаты в Overpay.
  5. Overpay возвращает ответ со статусом pending.
  6. Торговец отображает покупателю страницу для ввода одноразового пароля.
  7. Покупатель получает SMS-сообщение с одноразовым паролем.
  8. Покупатель вводит одноразовый пароль и инициирует продолжение оплаты.
  9. Торговец отправляет запрос на подтверждение транзакции, содержащий одноразовый пароль.
  10. Overpay присылает ответ на запрос подтверждения транзакции.
  11. Overpay отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у Overpay с помощью запроса получения статуса транзакции.
  12. Торговец отображает покупателю статус оплаты.

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
mobile_commerce
account_number
обязательный
 string (11)
Номер телефона покупателя, 11 цифр без специальных символов и без пробелов. Номер должен начинаться с кода 77.
Пример запроса 
{
    "request": {
        "amount": 1002,
        "currency": "KZT",
        "description": "test",
        "test": false,
        "tracking_id": "31765111-a44a-43f1-93f0-b70f81b97f9e",        
        "language": "en",        
        "return_url": "https://your-success.url",        
        "method": {
            "type": "mobile_commerce",
            "account_number": "77123456789"
        }
    }
}
Ответ
Пример ответа 
{
    "transaction": {
        "uid": "113fe130-3b11-11eb-11db-114b205ca951",
        "type": "payment",
        "status": "pending",
        "amount": 1002,
        "currency": "KZT",
        "description": "test",
        "created_at": "2025-04-26T07:15:00Z",
        "updated_at": "2025-04-26T07:15:00Z",
        "method_type": "mobile_commerce",
        "receipt_url": "https://backoffice.overpay.io/customer/transactions/a73fe130-3b66-45eb-80db-674b205ca951/628507edc0c73886eb09f6c6309fe599f0dbad33d392ffaac87bb415a801b4dc?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 5290,
            "ref_id": "18d28c32-c3f6-4acc-ba09-268b12ec7637",
            "message": "Transaction was initialized. Need approve."
        },
        "mobile_commerce": {
            "type": "mobile_commerce",
            "account_number": "77123456789"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction was initialized. Need approve.",
        "tracking_id": "31765111-a44a-43f1-93f0-b70f81b97f9e",
        "test": false,
        "language": "en",
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },       
        "gateway": {
            "iframe": false
        }
    }
}

Подтверждение транзакции

Запрос

Отправьте запрос подтверждения транзакции, указав uid, полученный в ответе на запрос оплаты, в качестве параметра пути.

POST https://api.overpay.io/beyag/transactions/{uid}/confirm

Укажите следующие параметры в теле запроса:
object
skip_duplicate_check
 boolean
Если false, отклоняет запрос, если в течение 30 секунд до этого был прислан запрос с таким же uid. По умолчанию, false.
password
обязательный
 string
Одноразовый пароль, SMS-код.
Пример запроса 
{
    "request": {            
        "password": "5576"
    }
}
Ответ
Пример ответа 
{
    "transaction": {
        "parent_uid": "113fe130-3b11-11eb-11db-114b205ca951",
        "type": "confirm",
        "status": "successful",
        "message": "Confirm was successfully processed.",
        "created_at": "2025-04-25T07:20:44+00:00",
        "amount": 1002,
        "currency": "KZT"
    }
}

Возврат средств

Запрос

Отправьте стандартный запрос возврата средств. Сумма возврата должна быть равна сумме родительской транзакции.

Выплата средств

Запрос

Отправьте запрос выплаты средств со следующими дополнительными данными:
object
object
Секция параметров способа оплаты.
type
обязательный
 string
mobile_commerce
account_number
обязательный
 string (11)
Номер телефона получателя выплаты, 11 цифр без специальных символов и без пробелов. Номер должен начинаться с кода 77.
Пример запроса 
{
  "request": {
    "amount": 2200,
    "currency": "KZT",
    "description": "test",
    "test": true,
    "tracking_id": "11-21212",
    "method": {
      "type": "mobile_commerce",
      "account_number": "77123456789"
    }
  }
}
Ответ
Пример ответа 
{
  "transaction": {
    "uid": "e785bbf1-dab2-4885-a42a-6de88d8bf999",
    "type": "payout",
    "status": "pending",
    "amount": 2200,
    "currency": "KZT",
    "description": "test tes test",
    "created_at": "2025-05-23T11:47:30Z",
    "updated_at": "2025-05-23T11:47:30Z",
    "manually_corrected_at": null,
    "method_type": "mobile_commerce",
    "receipt_url": "https://backoffice.overpay.io/customer/transactions/e785bbf1-dab2-4885-a42a-6de88d8bf999/1f2674fcf1c2a1b36d169218ea8797ead51516e1bc867033ba332e44011c62b5?language=en",
    "payout": {
      "status": "pending",
      "gateway_id": 5290,
      "ref_id": "42aa067d-f163-4a8c-b61a-5692da4e839c",
      "message": "Transaction was initialized."
    },
    "mobile_commerce": {
      "type": "mobile_commerce",
      "account_number": "77123456789"
    },
    "customer": {
      "email": null,
      "ip": null
    },
    "version": 0,
    "message": "Transaction was initialized.",
    "tracking_id": "52b77ae9-5f78-42a7-b715-e132896ed888",
    "test": false,
    "language": "en",
    "billing_address": {},
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    }      
  }
}