決済

決済は発送依頼ごとに行われます。依頼の確定時にクレジットカードの与信（オーソリ）を確保し、実際の請求は発送後に実施されます。

確定  → 見積額でカードの与信を確保（この時点では請求されない）
発送  → 実費で請求書を発行し、決済
支払後 → 確保していた与信を解放

支払いには yubin.app に登録済みのクレジットカードが使われます。カードの登録・変更は API では行えません。カードが登録されていない状態では発送依頼を作成できません（402 card_not_registered）。

確定時の与信

POST /v1/mails/{mailId}/confirm を呼ぶと、依頼作成時に算出した見積額（税込）で与信を確保します。実際の請求ではないため、この時点で引き落としは発生しません。カードの利用明細には一時的に yubin.app TEMP として表示されます。

与信が確保できない場合は 402 card_declined を返し、その依頼は削除されます。同じ依頼を再確定することはできないため、依頼の作成からやり直してください。

{
  "type": "https://docs.yubin.app/problems/card_declined",
  "title": "The card was declined",
  "status": 402,
  "code": "card_declined"
}

409 payment_in_progress は与信の失敗ではありません。同じ依頼の決済処理が進行中であることを示し、依頼は削除されずに残ります。時間をおいて再度確定してください。

なお、申告ページ数と実際の PDF が食い違う場合（422 page_count_mismatch）は請求額が狂うため、与信を取る前に失敗します。

依頼が発送されると、確定した実費で請求書が発行され、決済されます。支払いが完了すると、確保していた与信は解放されます。

与信額と最終的な請求額は一致しないことがあります。普通郵便の送料は依頼作成時点では概算であり、実際の重量・サイズで確定するためです。

決済に失敗した場合は自動的に再試行されます。