データモデルの理解
Card Products
こちらを読む感じだと、Card Productはクレカ商品を指します（なんとかカードってCMでやってるような感じのもの）。
物理カードやバーチャルのカードについて、動作や機能を定義することができます。Card Productで指定することが可能な属性は、カードがATMやオンラインで使用できるかどうか、また、現在有効であるかどうかを設定できます。物理カードの場合、Card Productは、カードの券面デザインを指定することができます。オプションとして、認証制御やベロシティ制御をCard Productに関連付けることで、関連するカードの使用場所や使用方法を制限することができます。
Cards
カードです。Card Productによって生成、管理できます。
作ってみる
チュートリアルではCurlで叩いてますが、Python SDKを使ってみます。
カードホルダであるユーザを作成（ダッシュボード）
ダッシュボードに記載があるHello Worldなcurlを実行してください。返却されたtokenをこの後使うのでメモしておいてください。
SDKの準備
私はpipでインストールしました。
pip install marqeta
基本的な使い方は以下の通りです。
from marqeta import Client
base_url = "ダッシュボードから取得"
application_token = "ダッシュボードから取得"
access_token = "ダッシュボードから取得"
timeout = 60 # seconds
client = Client(base_url, application_token, access_token, timeout)
Card Productトークンの取得
サンドボックスではすでにいくつかCard Productが作られています。その中から"Reloadable Card"という名前のCard Productのトークンを取得します。
card_products = client.card_products.list() # 25個しか取得できないという制限がある模様。25を超える場合、streamメソッド等を利用すること。
card_product_token = [x for x in card_products if x.name == 'Reloadable Card'][0].token
カードの作成
カードユーザ向けにカードを発行します。
先ほど作ったユーザに向けにカードを作成します。
data = {
"user_token": "a4e3decd-8540-4940-aebc-9b64b2e93e24",
"card_product_token": card_product_token}
client.cards.create(data)
カードの利用
商店のIDであるMID(merchant ID)を指定して、$10を擬似的に送ってみます。
シミュレータ実行はSDKでは用意されていないため、こちらからcurlを生成し呼び出します。
https://www.marqeta.com/docs/developer-guides/core-api-quick-start
作ったカードのトークンは、Pythonコード内でcreated_card.tokenで取得できます。
ダッシュボードを確認するとtransactionが作成されていました。
Authorization Control、Velocity Controlを作成するとトランザクションが流れそうです。一旦カードが作れて使えそうなことがわかったのでこの記事は、ここまでとします。