delete-saved-card

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

Kayıtlı bir kartı, saklandığı sağlayıcıdan ve gateway'den siler. Silinen kart varsayılan kartsa, müşterinin kalan kartlarından en son saklanan varsayılan olur.

Çalışma alanının planı kayıtlı kartları kapsamıyorsa istek 403 ile reddedilir.

Kimlik doğrulama

X-Api-Key, X-Signature, Content-Type: application/json. Ayrıntılar: Kimlik Doğrulama ve İmza.

İstek

{
  "customer": {
    "channel_token": "6f1c2e7a-4b3d-4c8e-9a61-2f5d7b0c3e14",
    "channel_reference": "musteri-88"
  },
  "saved_card": {
    "token": "7d3e9a10-2b4c-4f6e-8a1b-c2d3e4f5a6b7"
  }
}

Alan	Tip	Zorunlu	Açıklama
customer.channel_token	string (UUID)	evet	Müşterinin kanalı.
customer.channel_reference	string	evet	Müşterinin kimliği.
saved_card.token	string (UUID)	evet	Bu müşteriye ait kayıtlı kartın token'ı.

SDK örnekleri

PHP

use Gurmehub\Odemehub\Request\{DeleteSavedCard, NamedCustomer};

$deleted = $client->deleteSavedCard(new DeleteSavedCard(
    customer: new NamedCustomer(channelReference: 'musteri-88'),
    savedCardToken: $savedCardToken,
));

Node.js

const deleted = await client.deleteSavedCard({
    customer: { channelReference: 'musteri-88' },
    savedCardToken,
});

Python

from odemehub.request import DeleteSavedCard, NamedCustomer

deleted = client.delete_saved_card(DeleteSavedCard(
    customer=NamedCustomer(channel_reference="musteri-88"),
    saved_card_token=saved_card_token,
))

Java

import com.odemehub.request.DeleteSavedCard;
import com.odemehub.request.NamedCustomer;

var deleted = client.deleteSavedCard(new DeleteSavedCard(new NamedCustomer("musteri-88"), savedCardToken));

cURL

BODY='{"customer":{"channel_token":"6f1c2e7a-4b3d-4c8e-9a61-2f5d7b0c3e14","channel_reference":"musteri-88"},"saved_card":{"token":"7d3e9a10-2b4c-4f6e-8a1b-c2d3e4f5a6b7"}}'
SIGNATURE=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$ODEMEHUB_API_SECRET" | sed 's/^.* //')

curl -X POST "https://odeme.gurmehub.com/api/$ODEMEHUB_TEAM/gateway/delete-saved-card" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Api-Key: $ODEMEHUB_API_KEY" \
  -H "X-Signature: $SIGNATURE" \
  --data-raw "$BODY"

Yanıt

{
  "result": {
    "successful": true,
    "message": null
  },
  "saved_card": {
    "token": "7d3e9a10-2b4c-4f6e-8a1b-c2d3e4f5a6b7"
  },
  "customer": {
    "channel_reference": "musteri-88"
  }
}

Alan	Tip	Açıklama
result.successful	boolean	true: kart silindi. false: sağlayıcı kartı silmedi; kart kayıtlı kalır.
result.message	string | null	successful false ise nedeni.
saved_card.token	string	İstekteki kart token'ı. Bu yanıtta kartın diğer alanları yoktur.
customer.channel_reference	string	Müşterinin channel_reference değeri.

HTTP durum kodları

Kod	Durum
200	İstek işlendi; sonuç result.successful içinde.
401	API anahtarı ya da imza geçersiz.
403	Çalışma alanı işlem yapamıyor ya da planı kayıtlı kartları kapsamıyor.
422	Doğrulama hatası.

Hatalar

Alan	Mesaj
customer.channel_reference	Bu kanalda böyle bir müşteri bulunamadı.
saved_card.token	Bu müşteri için böyle bir kayıtlı kart bulunamadı.
saved_card.token	Bu kartın ödeme hesabı kart silmeyi desteklemiyor.