Skip to content

PlatonSDK

Platon edited this page Nov 16, 2017 · 8 revisions

Начальная точка использования Platon SDK находится здесь.

Прежде чем вы получите доступ к платежной платформе (Platon SDK) вы должны предоставить администраторам платежной платформы следующие данные:

  • Список IP-адресов - список ваших IP-адресов, с которых будут отправляться запросы на платежную платформу
  • URL-адрес обратного вызова - URL-адрес, который будет получать уведомления о результатах обработки вашего запроса на платежную платформу
  • Контактный адрес электронной почты - контактный адрес клиента

Примечание для почтового клиента:

Обратный вызов является обязательным, если вы работаете в асинхронном режиме или если ваша учетная запись поддерживает 3D-Secure. Длина URL-адреса обратного вызова не должна превышать 255 символов. Со всеми запросами POST Платформы Платформы на URL обратного вызова Клиент должен вернуть строка «OK», если он успешно получил данные или вернул «ERROR».

Примечание для веб-клиента:

Клиент должен предоставить обратный вызов URL (обратный вызов), на который будут отправляться уведомления в случае успешно выполненных платежей, а также возмещения и возврата уведомления. В любом случае, когда система отправляет запрос на обратный вызов, он должен вернуться HTTP 200, в противном случае система попытается снова отправить запрос до 5 раз.



Вы должны получить следующую информацию от администратора и установите их в AndroidManifest.xml, чтобы начать работу с платформой:

  • com.platon.sdk.CLIENT_KEY - ключ клиента
  • com.platon.sdk.CLIENT_PASS - пароль клиента
  • com.platon.sdk.PAYMENT_URL - URL-адрес платежа

Следующее поле требуется, если ваша учетная запись поддерживает 3DSecure:

  • com.platon.sdk.TERM_URL_3DS - URL-адрес обратного вызова пользователя 3DS

Детальнее о этих полях описано здесь.

Пример использования:

<meta-data
    android:name="com.platon.sdk.CLIENT_KEY"
    android:value="@string/your_client_key"/>
<meta-data
    android:name="com.platon.sdk.CLIENT_PASS"
    android:value="@string/your_client_pass"/>
<meta-data
    android:name="com.platon.sdk.PAYMENT_URL"
    android:value="@string/your_payment_url"/>
<meta-data
    android:name="com.platon.sdk.TERM_URL_3DS"
    android:value="@string/your_term_url_3ds"/>

Затем вы должны вызвать этот метод для инициализации с помощью вышеупомянутых полей:

PlatonSdk.init(yourContext);

Если вышеупомянутые поля не указаны в AndroidManifest.xml проекта или вы попытаетесь вызвать часть адаптера без инициализации, то вызовет PlatonSdkNotInitializedException.

Или вы можете запустить этот СДК следующим способом:

PlatonSdk.init(
    getApplicationContext(),
    getString(R.string.your_client_key),
    getString(R.string.your_client_pass),
    getString(R.string.your_payment_url)
);

Или если ваша учетная запись поддерживает 3DSecure:

PlatonSdk.init(
    getApplicationContext(),
    getString(R.string.your_client_key),
    getString(R.string.your_client_pass),
    getString(R.string.your_payment_url),
    getString(R.string.your_term_url_3ds)
);

Чтобы протестировать или смоделировать ваши запросы к платежной системе, используйте среду PlatonCard.Test.

Clone this wiki locally