Запрос на взимание платы
Банки-эквайеры могут применять различные сценарии и типы транзакций при проведении оплаты по сохраненным картам для вашей схемы расчета. Это означает, что вам необходимо было бы внедрять разные типы запросов при работе с несколькими эквайерами или при смене одного эквайера на другого.
eComCharge предлагает использовать единый запрос на взимание платы, который позволяет унифицировать процесс по привязке карт и списанию платы с них в дальнейшем.
Когда система eComCharge получает запрос на взимание платы, она автоматически преобразовывает такой запрос в платеж или авторизацию в зависимости от типа операции, поддерживаемого тем вашим эквайером, который будет обрабатывать транзакцию. Более того, если запрос на взимание платы был преобразован в запрос авторизации, система eComCharge самостоятельно отправит запрос на списание средств.
В личном кабинете запрос на взимание платы будет отображен транзакцией того типа, в которую этот запрос был преобразован, т.е. либо оплатой, либо авторизацией и списанием.
Запрос
Отправьте POST запрос на https://processing.ecomcharge.com/services/credit_cards/charges со следующими параметрами:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 100,
"currency": "USD",
"description": "Test transaction",
"tracking_id": "tracking_id_000",
"credit_card": {
"number": "5204240000015003",
"verification_value": "123",
"holder": "John Doe",
"exp_month": 10,
"exp_year": 2028
},
"additional_data": {
"browser": {
"screen_width": 1920,
"screen_height": 1080,
"screen_color_depth": 24,
"language": "en",
"java_enabled": false,
"user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36",
"time_zone": -180,
"time_zone_name": "Europe/Vilnius",
"accept_header": "*/*",
"window_height": 667,
"window_width": 600
},
"referer": "https://example.com/server/cs_post/post.php?order_id=5304380&security=949247¤cy=USD"
},
"three_d_secure": {
"advanced": false
},
"test": true
}
}
Ответ
Параметры ответа копируют параметры запроса и включают следующие дополнительные параметры:
|
|||||||||||||
Info
В настоящий момент, если вы указываете charge как значение параметра transaction_type при использовании платежного виджета eComCharge, значения параметров rrn и bank_code в ответе на запрос могут отсутствовать.
Пример ответа на запрос на взимание платы
{
"uid": "c74e1b00-9b94-4682-82c3-60167ce64841",
"parent_uid": "c74e1b00-9b94-4682-82c3-60167ce64841",
"status": "successful",
"amount": 100,
"currency": "USD",
"description": "Test transaction ütf",
"type": "charge",
"payment_method_type": "credit_card",
"tracking_id": "tracking_id_000",
"message": "Successfully processed",
"test": true,
"created_at": "2024-06-19T08:53:41.211Z",
"updated_at": "2024-06-19T08:53:46.217Z",
"paid_at": "2024-06-19T08:53:46.149Z",
"expired_at": null,
"closed_at": null,
"settled_at": null,
"manually_corrected_at": null,
"language": "en",
"redirect_url": "https://processing.ecomcharge.com/process/c74e1b00-9b94-4682-82c3-60167ce64841",
"credit_card": {
"holder": "John Doe",
"stamp": "a282993adc1299dacc79248e77e04c2995f79fcc9f82f408bec59ba20ff55739",
"brand": "master",
"last_4": "5003",
"first_1": "5",
"bin": "520424",
"bin_8": "52042400",
"issuer_country": null,
"issuer_name": null,
"product": null,
"exp_month": 10,
"exp_year": 2028,
"token_provider": null,
"token": null
},
"status_code": null,
"gateway": {
"iframe": true
},
"mute_notifications": null,
"id": "c74e1b00-9b94-4682-82c3-60167ce64841",
"additional_data": {
"referer": "https://example.com/server/cs_post/post.php?order_id=5304380&security=949247¤cy=USD"
},
"links": {
"receipt_url": "https://gateway.ecomcharge.com/customer/transactions/c74e1b00-9b94-4682-82c3-60167ce64841/33724a6fe94fe937575c6ed18d2ab8abdc34732df17e51be6da88e9b37356101?language=en"
},
"code": "S.0000",
"friendly_message": "The operation is successful.",
"smart_routing_verification": {
"status": "successful"
},
"charge": {
"auth_code": "654321",
"bank_code": "05",
"rrn": "999",
"ref_id": "777888",
"message": "Payment was approved",
"amount": 100,
"currency": "USD",
"billing_descriptor": "test descriptor",
"gateway_id": 3483,
"status": "successful"
},
"avs_cvc_verification": {
"avs_verification": {
"result_code": "1"
},
"cvc_verification": {
"result_code": "1"
}
},
"customer": {
"ip": null,
"email": null,
"device_id": null,
"birth_date": null,
"taxpayer_id": null,
"external_id": null,
"first_name": null,
"last_name": null,
"address": null,
"country": null,
"city": null,
"zip": null,
"state": null,
"phone": null
},
"billing_address": {
"first_name": null,
"last_name": null,
"address": null,
"country": null,
"city": null,
"zip": null,
"state": null,
"phone": null
}
}