Привязка карты получателю

Чтобы сотрудник мог получать деньги на свою карту необходимо добавить карту к получателю.

1. Формируете криптограмму (можно использовать SDK для Android и iOS в зависимости от устройства или использовать Скрипт checkout для web) в параметре MerchantPublicID передаете значение из метода https://api.cloudtips.ru/api/cards/publicid

2. Полученную криптограмму передаете в метод
   POST https://api.cloudtips.ru/api/cards/auth

   Content-Type application/json { CardholderName: "NONE", CardCryptogramPacket: криптограмма из пункта 1, UserId: {уникальный идентификатор получателя}, IpSource: "192.168.0.0" }

   Также необходимо прокидывать параметр IP адрес пользователя, который выполняет запрос в параметре IpSource

3. Далее возможны два варианта. Первый вариант если карта не 3ds, либо получатель уже проходил его ранее (Frictionless Flow)
   Тогда будет ответ:

   { TransactionId: 123345, StatusCode: "Canceled", CardToken: "tk_sometoken" }

4. Второй вариант, если получатель проходит полный 3ds с вводом смс кода (Challenge Flow)
   Тогда будет ответ:

   { TransactionId: 123345, StatusCode: "Need3ds", Md: "123345", PaReq: "TESTPAREQ", AcsUrl: "https://bank-acs-url.ru" }

5. Если это Challenge Flow, то необходимо перенаправить получателя на AcsUrl банка для ввода 3ds-ного кода. Для этого необходимо перенаправить получателя на AcsUrl банка для прохождения 3ds.

   Для проведения 3-D Secure аутентификации нужно отправить плательщика на адрес, указанный в параметре AcsUrl из метода Авторизация платежа с передачей следующих параметров:

   • MD — параметр TransactionId из ответа сервера;

   • PaReq — одноименный параметр из ответа сервера;

   • TermUrl — адрес на вашем сайте для возврата плательщика после аутентификации.

   • Далее необходимо вызвать метод https://api.cloudtips.ru/api/cards/post3ds со следующими параметрами:

   • { "md": {значение из ответа после acsUrl}, "paRes": {значение из ответа после acsUrl}, "userId": {уникальный идентификатор получателя} }

6. При успешном окончании методов 3, 4 или 5 необходимо подтвердить привязку карты на стороне системы
   POST https://api.cloudtips.ru/api/cards/add

   Content-Type application/json { TransactionId: {из ответа пункта 3, 4 или 5}, "userId": {уникальный идентификатор получателя} }

Получение списка карт получателя

Описание: Позволяет получить все карты привязанные получателем

Адрес: https://api.cloudtips.ru/api/cards?userId={userId}, где userId - уникальный идентификатор получателя

Тип: GET

Ответ:

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

{
  "data": [
    {
      "firstSix": "string",
      "lastFour": "string",
      "cardType": "string",
      "cardExpirationDate": "string",
      "issuerCode": "string",
      "token": "string",
      "isDefault": true,
      "commissionHint": "string"
    }
  ],
  "succeed": true,
  "errors": [
    "string"
  ],
  "validationErrors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  }
}

Удаление карты

Описание: Удаление карты получателя. Карту по умолчанию удалить можно, дефолтной становится та, которая идет сверху списка. Если осталась только одна дефолтная карта, то она все равно будет удалена.

Адрес: https://api.cloudtips.ru/api/cards/

Тип: DELETE

Запрос:

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

{
  "cardToken": "string",
  "userId": "string"
}

Ответ:

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

{
  "succeed": true,
  "errors": [
    "string"
  ],
  "validationErrors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  }
}

Смена дефолтной карты

Описание: Изменить карту, на которую выплачиваются чаевые по умолчанию

Адрес: https://api.cloudtips.ru/api/cards/default

Тип: POST

Запрос:

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

{
  "cardToken": "string",
  "userId": "string"
}

Ответ:

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

{
  "succeed": true,
  "errors": [
    "string"
  ],
  "validationErrors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  }
}

Получение publicId для привязки карты

Описание: Позволяет получить publicId для формирования криптограммы

Адрес: https://api.cloudtips.ru/api/cards/{userId}/publicid

Тип: GET

Запрос:

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

https://api.cloudtips.ru/api/cards/80eb050b-77c7-475c-ba98-70cf45f0003c/publicid

Ответ:

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

{
  "data": {
    "publicId": "string"
  },
  "succeed": true,
  "errors": [
    "string"
  ],
  "validationErrors": {
    "additionalProp1": [
      "string"
    ]
  }
}