# 決済

> 発送依頼ごとの与信確保と、発送後の請求までの流れ。

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

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

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

## 確定時の与信

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

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

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

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

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

## 発送後の請求

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

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

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

:::caution[プリペイドカード・デビットカードを利用する場合]
これらのカードでは与信の時点で残高が引き落とされ、解放は後日返金として戻ります。発送後の請求と与信の解放にはタイムラグがあるため、その間は与信額と請求額の両方が同時に残高から引かれた状態になります。

**見積額の 2 倍以上の資金を事前に用意してください。** 残高が不足すると確定時の与信、あるいは発送後の請求が失敗します。
:::