3DS Doğrulamasını Sonuçlandır
POST
/v1/payments/{id}/3ds-callbackOptionalBir 3DS doğrulama sürecini tamamlar. Barındırılan ödeme sayfası, ACS pares değerini ve kart çekim yanıtından dönen correlationId'yi gönderir. Idempotent'tir — tekrarlanan bir gönderim, kazanan kaydı bayt bayt aynı şekilde döndürür.
Kimlik Doğrulama
İmza Deseni
HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/payments/{id}/3ds-callback\n{sha256(body)}")| Başlık | Değer | Açıklama |
|---|---|---|
X-Api-Key | pk_live_a1b2c3d4e5f6g7h8 | Merchant public API key |
X-Signature | {hmac_sha256_hex} | Hex HMAC-SHA256 request signature (see below) |
X-Timestamp | 2026-04-13T10:00:00Z | ISO 8601 UTC request time, validated within ±5 min |
İstek Parametreleri
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
pares | string | Zorunlu | Signed ACS assertion from the 3DS challenge |
correlationId | string | Zorunlu | Value round-tripped from the card charge response |
İstek Örneği
JSONİstek Gövdesi
{
"pares": "eyJjaGFsbGVuZ2VJZCI6Ii4uLiJ9.9a8b7c6d",
"correlationId": "c0rr-3f1c-9a2e-6b4d"
}Yanıt Parametreleri
| Alan | Tür | Örnek |
|---|---|---|
id | string | "pay_1a2b3c4d5e6f" |
status | string | "captured" |
amount | integer | 15000 |
currency | string | "TRY" |
commission | integer | 449 |
netAmount | integer | 14551 |
authCode | string | "123456" |
completedAt | string | "2026-04-13T10:00:05Z" |
Yanıt Örneği
JSONYanıt
{
"id": "pay_1a2b3c4d5e6f",
"status": "captured",
"amount": 15000,
"currency": "TRY",
"commission": 449,
"netAmount": 14551,
"authCode": "123456",
"completedAt": "2026-04-13T10:00:05Z"
}Durum Kodları
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
POSThttps://api.pay.sandbox.kvell.group