Ana içeriğe geç

delete-saved-card

POST /api/{team}/gateway/delete-saved-card/{token}

Kayıtlı kartı önce kartın saklandığı ödeme hesabında, sonra ödemehub'da siler. Ödeme hesabı silmeyi reddederse kart silinmez ve neden result.message'da döner. Silinen kart müşterinin varsayılan kartıysa, müşterinin en son saklanan kartı varsayılan olur.

Kimlik doğrulama​

X-Api-Key, X-Timestamp, X-Signature, Content-Type: application/json. Ayrıntılar: Kimlik Doğrulama ve İmza. Uç, ödeme sınırına (dakikada 60) tabidir.

İstek​

{
"token": "2d4f6a8c-0e1b-4c3d-9f5e-7a9b1c3d5e6f"
}
AlanTipZorunluAçıklama
tokenstringevetKartın token'ı. Adresteki token'la aynı olmalıdır.

SDK örnekleri​

not

Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.

use Gurmehub\Odemehub\Request\DeleteSavedCard;

$deleted = $client->deleteSavedCard(new DeleteSavedCard($cardToken));

if (! $deleted->result->successful) {
$deleted->result->message;
}

Yanıt​

{
"result": { "successful": true, "message": null },
"saved_card": {
"token": "2d4f6a8c-0e1b-4c3d-9f5e-7a9b1c3d5e6f"
},
"customer": {
"reference": "musteri-88"
}
}
AlanTipAçıklama
result.successfulbooleanKart silindiyse true. Ödeme hesabı reddettiyse false, yanıt yine 200.
result.messagestring | nullsuccessful false ise nedeni.
saved_card.tokenstringSilinen (ya da silinemeyen) kartın token'ı. SDK'larda savedCardToken / saved_card_token olarak okunur.
customer.referencestringKartın saklandığı müşteri referansı.

HTTP durum kodları​

KodDurum
200İstek işlendi; sonuç result.successful içinde.
401API anahtarı ya da imza geçersiz.
403Çalışma alanı işlem yapamıyor ya da Kayıtlı Kartlar modülü kapalı.
404Bu kayıtlı kart bulunamadı.
422Doğrulama hatası.
429İstek sınırı aşıldı.

Hatalar​

AlanMesaj
tokenGövdedeki token adresteki token ile aynı olmalı.
tokenBu kartın ödeme hesabı kart silmeyi desteklemiyor.