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

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

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

Info

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

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

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

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:

Параметр	Тип	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения оплаты.
method	object	Секция параметров способа оплаты.
type * обязательный	string	mobile_commerce
account_number * обязательный	string (11)	Номер телефона покупателя, 11 цифр без специальных символов и без пробелов.

Пример запроса

{
    "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": "12345678901"
        }
    }
}

Ответ

Пример ответа

{
    "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": "12345678901"
        },
        "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

Укажите следующие параметры в теле запроса:

Параметр	Тип данных	Описание
request	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"
    }
} 

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

Запрос

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

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

Запрос

Отправьте запрос выплаты средств со следующими дополнительными данными:

Параметр	Тип данных	Описание
request	object
method	object	Секция параметров способа оплаты.
type * обязательный	string	mobile_commerce
account_number * обязательный	string (11)	Номер телефона получателя выплаты, 11 цифр без специальных символов и без пробелов.

Пример запроса

{
  "request": {
    "amount": 2200,
    "currency": "KZT",
    "description": "test",
    "test": true,
    "tracking_id": "11-21212",
    "method": {
      "type": "mobile_commerce",
      "account_number": "12345678902"
    }
  }
}

Ответ

Пример ответа

{
  "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": "12345678902"
    },
    "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"
      }
    }      
  }
}