よくあるご質問
こちらはAPI連携を前提とした開発ご担当者さま向けのAPI仕様についてのよくあるご質問です。APIのご利用には弊社内の審査がございますのであらかじめご了承ください。
有効期限はどのようなものが取得できますか
各Responseで取得できる有効期限は以下の種類があります。
１．商品ごとの有効期限
「available_period」項目を参照ください。
発行API、参照APIのどちらでも確認ができ...
取得したギフトチケットの有効期限をユーザーに提示したいのですが、どうすれば良いですか
ギフトチケット有効期限の取得方法
GiftCard発行APIでギフトを発行したのち、GiftCard参照APIにてギフトチケットごとの有効期限（expires_at）をご確認いただくことがで...
エラーコード一覧
エラーコードおよびその原因、対処法については以下をご参照ください。
※基本⽅針は RFC7807 に準拠します。
400 Bad Request
このエラーが出た場合には、リクエスト内容が誤...
検証環境のエンドポイントはありますか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」「えらべるタイプ（giftee Box/えらべるPay）」
検証環境用のエンドポイントはございません。テスト疎通を行...
APIリクエストに送信上限数はありますか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」「えらべるタイプ（giftee Box/えらべるPay）」
Rate limit は⾮公開です。
「秒間/10リクエス...
GiftCard参照APIのレスポンス項⽬「expires_at」がnullでレスポンスされる時があるのはなぜですか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」
リクエストが集中した際など、ギフトURL発⾏後、有効期限が確定するまでに若⼲のタイムラグが発⽣し、「null」でレス...
発行したギフトカードのチケット有効期限を確認することは可能ですか
以下をご確認ください。
対象：「単品タイプ（単一ギフト）」
ギフトURL発行後、GiftCard参照APIをリクエストしていただければ、ギフトの有効期限をレスポンス（expires_at）いた...
ギフトカードAPIをリクエストして、途中でタイムアウトした（レスポンスを受け取れない）場合は、どうすればいいですか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」「えらべるタイプ（giftee Box/えらべるPay）」
必ず同一の「issue_identity」で再リクエスト...
giftee Box発⾏APIのリクエスト項⽬「initial_point（発⾏するgiftee Boxの初期ポイント）」は、1円単位でのリクエストが可能ですか
以下をご確認ください。
対象：「えらべるタイプ（giftee Box/えらべるPay）」
「initial_point（発⾏するgiftee Boxの初期ポイント）」の設定可能な金額範囲や単...
レスポンスされたギフトURLを表⽰させる際の注意事項はありますか
ご注意事項については以下をご確認ください。
対象：「単品ギフト」「えらべるタイプ（giftee Box/えらべるPay）」
レスポンスしたギフトURLは「ブラウザ起動/遷移」して表示してくださ...
対象の「issue_identity」で過去に発⾏していないか確認できますか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」「えらべるタイプ（giftee Box/えらべるPay）」
参照APIで該当の「issue_identity」をリク...
issue_identityの生成ルールはありますか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」「えらべるタイプ（giftee Box/えらべるPay）」
仕様書をご確認の上、文字数は100文字以下で生成してくださ...
curlコマンドのサンプルはありますか？
以下より該当するサンプルをご利用ください。
ギフトカード：発行API
curl -X POST -H "Authorization: Basic <Base64 encoded token>...
GiftCard発行と参照APIのレスポンス項目にある「content」の「image_url」をHPやアプリに表示しても問題ないでしょうか
以下をご確認ください。
対象：「単品ギフト」「えらべるタイプ（giftee Box/えらべるPay）」
審査でギフト提供元ブランドからの承諾を得ていれば、HPやアプリにご使用いただいても問題...
ギフトカード発行キャンセルAPIはありますか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」「えらべるタイプ（giftee Box/えらべるPay）」
一度発行したギフトのキャンセルAPIのご用意はございません。
誤ったポイント（initial_point）値でgiftee Boxを発⾏した場合にキャンセルできますか
以下をご確認ください。
対象：「えらべるタイプ（giftee Box/えらべるPay）」
発行したギフトのキャンセルはできません。
誤ったポイントで発⾏した場合でも、発⾏済みのギフトは全て請...
APIの制御で、案件申し込みで設定したメッセージカードのカードデザインを変更することはできますか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」
APIでは、表示/非表示の制御のみ可能となります。「申込みサイト」から設定したメッセージカードのカードデザインは変更...
メッセージカード画面を表示させずにチケット画面を表示することはできますか
以下をご確認ください。
対象：「単品タイプ（単一ギフトor選べるギフト）」
可能です。
「申込みサイト」からお申し込みの際に、以下のメッセージカードの有無選択画面にて「無し」を選択し、Gif...