default-saved-card

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

Kayıtlı bir kartı müşterinin varsayılan kartı yapar; önceki varsayılan kartın is_default değeri false olur. Abonelik yenilemeleri varsayılan karttan çekilir.

Ç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\{DefaultSavedCard, NamedCustomer};

$client->defaultSavedCard(new DefaultSavedCard(
    customer: new NamedCustomer(channelReference: 'musteri-88'),
    savedCardToken: $savedCardToken,
));

Node.js

await client.defaultSavedCard({
    customer: { channelReference: 'musteri-88' },
    savedCardToken,
});

Python

from odemehub.request import DefaultSavedCard, NamedCustomer

client.default_saved_card(DefaultSavedCard(
    customer=NamedCustomer(channel_reference="musteri-88"),
    saved_card_token=saved_card_token,
))

Java

import com.odemehub.request.DefaultSavedCard;
import com.odemehub.request.NamedCustomer;

client.defaultSavedCard(new DefaultSavedCard(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/default-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",
    "payment_provider_token": "1c9e8f7a-6b5d-4c3e-2a1f-0e9d8c7b6a54",
    "holder_name": "AHMET YILMAZ",
    "scheme": "mastercard",
    "first_digits": "54003600",
    "last_four_digit": "0003",
    "expiry_month": "12",
    "expiry_year": "2030",
    "is_default": true,
    "created_at": "2026-09-29T10:15:00.000000Z"
  },
  "customer": {
    "channel_reference": "musteri-88"
  }
}

saved_card: kart nesnesi.

HTTP durum kodları

Kod	Durum
200	Kart varsayılan yapıldı.
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ı.