Відкладене списання з Apple Pay

Дозволить вам обміняти токен Apple Pay на токен Tranzzo для подальшого відкладеного списання.

Як це працює?

Платник формує замовлення на вашому сайті/мобільному застосунку та підтверджує замовлення
Ви створюєте сесію Apple Pay
Платник натискає кнопку оплати Apple Pay
Ви отримуєте токен Apple Pay та обмінюєте його на токен Tranzzo
Ініціюєте списання з cc_token Tranzzo за замовлення після його обробки на будь яку суму

У вас є можливість обміняти токен Apple Pay у один із таких способів:

Direct-інтеграція (розміщення кнопки оплати Apple Pay на вашому сайті або у мобільному застосунку).
Інтеграція з використання токенізаційного віджета (розміщення кнопки оплати Apple Pay у нашому віджеті).

Direct інтеграція

Особливості використання direct-інтеграції:

Платіжна сторінка повинна використовувати HTTPS-протокол.
Дані кожного клієнта мають бути сталими та унікальними.
Використовуйте HTTP-метод POST.

Приклад запиту на створення сесії Apple Pay

curl -X 'POST' \
  'https://cpay.tranzzo.com/api/v1/applepay/session' \
  -H "Content-Type: application/json" \
  -H "X-API-AUTH: CPAY ${API_KEY}:${API_SECRET}" \
  -H "X-API-KEY: ${ENDPOINTS_KEY}" \
  -d '{
  "pos_id": "'$POS_ID'",
  "validation_url": "https://apple-pay-gateway.apple.com/paymentservices/startSession"
}'

Після створення сесії і отримання токену Apple Pay, необхідно його обміняти на токен Tranzzo

Параметри запиту

Parameter	Type	Required	Description
`pos_id`	UUID	✅	Merchant's identifier (`POS_ID`)
`token`	String	✅	Token Apple Pay

Приклад запиту на обмін токену Apple Pay на токен Tranzzo

curl -X 'POST' \
  'https://api.tranzzo.com/api/v1/tokenization/tokenize' \
  -H "Content-Type: application/json" \
  -H "X-API-AUTH: CPAY ${API_KEY}:${API_SECRET}" \
  -d '{
  "pos_id": "${POS_ID}",
  "token": "applepay:eyJwYXltZW50RGF0YSI6eyJ2ZXJzaW9uIjoiRUNfdjEiLC..."
}'

Параметри відповіді

Parameter	Type	Description
`cc_token`	String	Tranzzo token

Приклад відповіді

{
  "cc_token": "ODJkZjBhNmY2OTMyNDJlN2wjMjFjfTQzOXU3ZDFhYzI6cWJmWHFmMHlzM3hYaXJMWEZv"
}

інформація

Для подальшого списання коштів з картки платника по cc_token використовуйте Одностадійний платіж (purchase)

Використання токенізаційного Widget

Деталі інтеграції та використання токенізаційного віджета.

інформація

Для активації роботи Apple Pay у токенізаційному віджеті зверніться у службу підтримки Tranzzo

Наступні кроки

Тестування процесу обміну токену і оплати:

Створіть обліковий запис у Мерчант-порталі.
Використовуйте автентифікаційні дані тестового проєкту.
Налаштуйте вебхуки.
Скористайтеся даними для тестування для отримання різних кодів результатів операцій
Опрацьовуйте отримані помилки.

Більше деталей — у контрольному списку інтеграції.

Дивіться також:

Direct інтеграція​

Direct інтеграція