Сбербанк PAY

Сервис для приема платежей в интернет-магазинах через Национальную Платежную Систему. Реализация оплаты заключается в создании формы на странице продавца, в которой будут собираться данные о карте — номер, дата истечения, CVV. При этом важно упомнянуть тот факт, что эти персональные данные не должны никак сохранятся на вашем сервере. Идеальный вариант: чтобы они слались напрямую с клиента к нам на сервер, а уже полученный с нашего сервера токен и сопуствующие данные можно уже сохранять для дальнейшей работы.

Процесс оплаты ¶

Первый этап заключается в сохранении на сервере Банка персональной информации. Для этого делается запрос на токен — просто ключ к сохраненной информации о карте. При этом сам сервер Банка не сохраняет персональные данные в открытом виде, данные лежат зашифрованными. Для доступа к ним нужен полный токен, который возвращается клиенту при запросе. Токен при этом находится в состоянии pending — в ожидании подтверждения.

Второй этап — подтверждение токена. Это дополнительный уровень безопасности для онлайн операций. Для этого клиента просто надо перенаправить на страницу 3d-secure (3ds) и ожидать прохождения этой процедуры с возвратом на указанную вами страницу. После подтверждения токен переходит в статус chargeable — в таком состоянии позволяется с помощью токена списывать деньги с карты клиента.

Третий этап — оплата. Она не проходит автоматически после подтверждения токена. Это имеет смысл, так как токены могут являться многоразовыми (но для разовых операций старайтесь избегать такого поведения, клиенту в случае многоразового токена будет показано предупреждение о неограниченном доступе к карте при подтверждении токена). Если токен одноразовый (с заявленной суммой при создании), то токен переходит после оплаты в состояние charged, если многоразовый, то так и остается в состоянии chargeable. Оплату по многоразовому токену можно вызывать неограниченно (но в пределах лимитов карты, которые указываются клиентом в банке самостоятельно).

В случае каких-либо проблем, можно однократно выполнить отмену платежа, в таком случае токен перейдет в статус refunded (если он одноразовый).

В любой момент вы можете набюдать за статусом созданного вами токена.

Ключи ¶

После регистрации в системе вам выдается 2 ключа: публикуемый (pk) и секретный (sk).

• pk - это ключ, который можно размещать в открытых источниках и он используется только для создания токена

• sk - ключ, которым проивзодятся остальные операции - оплата, возврат, а также получается информация о существующих объектах текущего клиента.

Content-Type: application/x-www-form-urlencoded

Content-Type: application/json

{
  "token": "tok_33a58e48-5ac6-4806-aecd-392637e95da3$$n1SGqf6-Xe0e9v7TCTc9AQ",
  "last4numbers": "8709",
  "created": "2018-01-23T11:13:25.910+02",
  "status": "pending",
  "three_ds_required": true,
  "exp_month": 6,
  "exp_year": 18,
  "bank": "21",
  "type": "NPS",
  "subscription": false
}

X-Secret: sk_ABC123

Content-Type: application/json

{
  "created": "2018-01-23T11:13:25.000+02",
  "status": "charged",
  "three_ds_required": true,
  "amount": 75,
  "currency": "000"
}

X-Secret: sk_ABC123

Location: https://3ds.bank-name.test/some_code

Content-Type: application/x-www-form-urlencoded
X-Secret: sk_ABC123

Content-Type: application/json

{
  "id": "ch_9cb0a8db-6378-41f4-86f6-bfb8ac55febe",
  "created": "2018-01-23T11:15:30.000+02",
  "paid": true,
  "reference": "000002812310"
}

X-Secret: sk_ABC123

Content-Type: application/json

{
  "id": "ch_9cb0a8db-6378-41f4-86f6-bfb8ac55febe",
  "created": "2018-01-23T11:15:30.000+02",
  "currency": "000",
  "amount": 75,
  "paid": true,
  "reference": "000002812310",
  "refunds": [
    {
      "id": "re_ad26b88c-61ca-4755-90f4-b72ab015328c",
      "date": "2018-01-23T11:17:49.000+02",
      "refunded": true
    },
    {
      "id": "re_e52cd23b-d422-4128-abc9-893046503270",
      "date": "2018-01-23T11:17:52.000+02",
      "refunded": false
    },
    {
      "id": "re_080dbd3b-a777-440a-9d5c-810d8e4c9b6b",
      "date": "2018-01-23T11:17:54.000+02",
      "refunded": false
    }
  ]
}

X-Secret: sk_ABC123

Content-Type: application/json

{
  "id": "re_080dbd3b-a777-440a-9d5c-810d8e4c9b6b",
  "token": "tok_33a58e48-5ac6-4806-aecd-392637e95da3$$n1SGqf6-Xe0e9v7TCTc9AQ",
  "date": "2018-01-23T11:17:54.283+02",
  "refunded": true
}

{
  "id": "re_080dbd3b-a777-440a-9d5c-810d8e4c9b6b",
  "token": "tok_33a58e48-5ac6-4806-aecd-392637e95da3$$n1SGqf6-Xe0e9v7TCTc9AQ",
  "date": "2018-01-23T11:17:54.283+02",
  "refunded": false
}