update-saved-card

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

Kartı müşterinin varsayılan kartı yapar; müşterinin önceki varsayılan kartı varsayılan olmaktan çıkar. Abonelik dönemleri varsayılan karttan çekilir. Bir kart doğrudan varsayılanlıktan çıkarılamaz; bunun için müşterinin başka bir kartı varsayılan yapılır.

Kimlik doğrulama

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

İstek

{
  "token": "2d4f6a8c-0e1b-4c3d-9f5e-7a9b1c3d5e6f",
  "saved_card": {
    "is_default": true
  }
}

Alan	Tip	Zorunlu	Açıklama
token	string	evet	Kartın token'ı. Adresteki token'la aynı olmalıdır.
saved_card.is_default	boolean	evet	true olmalıdır. saved_card nesnesinde başka anahtar gönderilemez.

SDK örnekleri

not

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

PHP

use Gurmehub\Odemehub\Request\UpdateSavedCard;

$details = $client->updateSavedCard(new UpdateSavedCard($cardToken));

$details->savedCard->isDefault;   // true

Node.js

const details = await client.updateSavedCard({ token: cardToken });

details.savedCard?.isDefault;   // true

Python

from odemehub.request import UpdateSavedCard

details = client.update_saved_card(UpdateSavedCard(token=card_token))

details.saved_card.is_default   # True

Java

import com.odemehub.request.UpdateSavedCard;

var details = client.updateSavedCard(new UpdateSavedCard(cardToken));

details.getSavedCard().isDefault();   // true

cURL

URI_PATH="/api/$ODEMEHUB_TEAM/gateway/update-saved-card/2d4f6a8c-0e1b-4c3d-9f5e-7a9b1c3d5e6f"
BODY='{"token":"2d4f6a8c-0e1b-4c3d-9f5e-7a9b1c3d5e6f","saved_card":{"is_default":true}}'
TIMESTAMP=$(date +%s)
SIGNATURE=$(printf '%s\n%s\n%s\n%s' "$TIMESTAMP" "POST" "$URI_PATH" "$BODY" | openssl dgst -sha256 -hmac "$ODEMEHUB_API_SECRET" | sed 's/^.* //')

curl -X POST "https://sandbox.odemehub.com$URI_PATH" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $ODEMEHUB_API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  --data-raw "$BODY"

Yanıt

retrieve-saved-cards ile aynıdır: result, kartın güncel hâli (saved_card, is_default: true) ve customer.

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, planı kayıtlı kartları kapsamıyor ya da Kayıtlı Kartlar modülü kapalı.
404	Bu kayıtlı kart bulunamadı.
422	Doğrulama hatası.
429	İstek sınırı aşıldı.

Hatalar

Alan	Mesaj
token	Gövdedeki token adresteki token ile aynı olmalı.
saved_card.is_default	Kart yalnızca varsayılan yapılabilir; varsayılanı değiştirmek için müşterinin başka bir kartını varsayılan yapın.