Alipay
この決済手段は現在テスト環境のみ利用できます。
本番環境での利用開始時期は調整中です。
概要
Alipay（支付宝、アリペイ）は、中国のアリババグループが提供する、世界中で数億人のお客様に利用されている決済手段です。
お客様はAlipayアカウントに紐づいた銀行口座やデビットカードなどからチャージをして決済ができます。
Alipayを始めるには
-
契約の確認・申込
ご利用にはAlipay決済の契約が必要です。未契約の場合は営業担当へご連絡ください。 -
テスト環境での動作確認
テスト環境に関する情報はこちらを確認してください。 -
本番稼働開始
動作確認完了後、本番運用を開始します。 テスト環境⇒本番環境への切り替えチェックリストはこちら
接続方式のサポート
| 接続方式 | サポート状況 | 関連リンク |
|---|---|---|
| OpenAPIタイプ | ✔ 対応 | API仕様 |
| プロトコルタイプ | ✖ 非対応 | |
| リンクタイプ Plus | ✔ 対応 | API仕様／決済識別子 |
取引状態
WEBブラウザ利用の場合
| 取引状態 | コード | 説明 |
|---|---|---|
| 未決済 | UNPROCESSED | 都度支払い（/wallet/charge）API が失敗した状態 |
| 要求成功 | REQSUCCESS | 都度支払い（/wallet/charge）API が成功し、支払い準備が整った状態（まだお客様は支払っていません） |
| 認証処理中 | AUTHPROCESS | お客様がAlipayで支払い操作中の状態 |
| 即時売上 | CAPTURE | 決済が正常に完了した状態 |
| キャンセル | CANCEL | 取引がキャンセルされた状態 |
| 決済失敗 | PAYFAIL | 決済がエラーとなり支払いに失敗した状態 |
| 期限切れ | EXPIRED | 支払操作が未完了で期限切れとなった状態 |
アプリ利用の場合
| 取引状態 | コード | 説明 |
|---|---|---|
| 未決済 | UNPROCESSED | 都度支払い（/wallet/charge）API が失敗した状態 |
| 要求成功 | REQSUCCESS | 都度支払い（/wallet/charge）API が成功し、支払い準備が整った状態（まだお客様は支払っていません） |
| 即時売上 | CAPTURE | 決済が正常に完了した状態 |
| キャンセル | CANCEL | 取引がキャンセルされた状態 |
| 決済失敗 | PAYFAIL | 決済がエラーとなり支払いに失敗した状態 |
| 期限切れ | EXPIRED | 支払操作が未完了で期限切れとなった状態 |
返金
- キャンセル期限：即時売上日から180日後の23:59:59まで
- 返金上限回数：なし
返金時は決済時に選択した支払い手段に返金されます。
例えば銀行口座を用いてチャージを行った場合、銀行口座への返金が行われます。
金額変更
増額
増額はできません。
減額
一部返金をすることで減額が可能です。
期限切れ
- Alipay画面での決済期限：10分 ※起算時刻は都度支払い（
/wallet/charge）APIの実行時点 - 当サービスがAlipayから期限切れの通知を受信した時点で状態を「期限切れ」に更新します。
画面遷移イメージ
WEBブラウザ利用の場合
アプリ利用の場合
その他留意事項
為替レートと返金
- お客様は人民元（CNY）でチャージ、支払いを行います。決済時にAlipayが人民元を日本円に換算し、日本円で決済が完了します。
- 為替レートは取引ごとに決済時点で固定されるため、返金額は決済金額と同じになります。
実装時の注意事項
コールバック直後の取引照会
コールバック直後に取引照会（/order/inquiry）APIを行った際、稀に AUTHPROCESS が返却されることがあります。
その場合は時間をおいて再度 取引照会（/order/inquiry）APIを行ってください。
キャンセル・金額変更処理でのエラーハンドリング
キャンセル（/order/cancel）APIまたは金額変更（/order/update）APIにて、bad_gatewayエラーが返却された場合は、同じパラメータで必ずリトライしてください。
同じエラーが1時間以上続く場合は、お問い合わせください。
リダイレクト方式の指定
walletChargeOptions.transitionType の値によって、Alipayへのリダイレクト方式を指定可能です。
お客様が購入を行うデバイスがWEBブラウザかアプリかによって、以下の通り指定してください。
アプリ利用の場合、加盟店様のアプリからAlipayアプリを直接起動する必要があります。
| デバイス | リクエストwalletChargeOptions.transitionType | リクエストpayer.osType | レスポンスredirectUrl |
|---|---|---|---|
| WEBブラウザ | "WEB_LINK" もしくは省略 | － | httpsから始まるブラウザのリンクが返却 |
| アプリ | "APP_LINK" | "IOS", "ANDROID" | Alipayアプリのディープリンクが返却 |
Alipayミニアプリ
Alipayミニアプリには対応していません。
対応する支払いパターンと運用方法の組み合わせ
対応する支払いパターンおよび運用方法の組み合わせは以下の通りです。
| 支払いパターン | 仮売上/実売上運用 | 即時売上運用 |
|---|---|---|
| 都度支払い | ✖ 非対応 | ✔ 対応 |
| 随時支払い | ✖ 非対応 | ✖ 非対応 |
ロゴ画像
必ずロゴマーク利用ガイドラインを確認の上ご利用ください。