9Pay - WooshPay

ベトナムのお客様から人気を集めているデジタルウォレット「9Pay」についてご紹介します。 #

数百万人を超えるユーザーを抱える9Payは、ベトナムを代表するデジタルウォレットであり、個人の多様な決済ニーズに応えています。これは、日常生活で役立つさまざまな便利な機能を備えたオールインワンアプリです。

特徴 #

通貨の処理	VND
決済通貨	米ドル
最低取引額	国内デビットカード最低額：10,000 VND 国際カード最低額：10,000 VND 9Pay 電子ウォレット最低額：5,000 VND 銀行振込最低額：10,000 VND
最大取引額	国内デビットカード上限：2億VND 国際カード上限：2億VND 9Pay 電子ウォレット上限：100,000,000 VND 銀行振込上限：なし
払い戻し	✅
一部払い戻し	✅
複数回の一部払い戻し	✅
チャージバック	✅

サブプロダクト #

製品	説明
9Pay 電子ウォレット	販売店のチェックアウト画面で「9Pay」を支払い方法として選択すると、顧客は9Payの支払いページにリダイレクトされます。そこで「9Pay E-wallet」を選択すると、QRコードが表示されます。その後、購入者はスマートフォンで9Payアプリを開き、ブラウザ画面に表示されたQRコードをスキャンして支払いを完了します。
国内デビットカード	販売店のチェックアウト画面で「9Pay」を支払い方法として選択すると、顧客は9Payの支払いページにリダイレクトされます。その後、現地のデビットカードと現地の銀行名を選択し、カード情報を入力して支払いを完了します。
国際カード	加盟店のチェックアウト画面で「9Pay」を支払い方法として選択すると、お客様は9Payの支払いページにリダイレクトされます。支払い方法として「国際カード」を選択し、カード情報を入力すると、支払いが完了します。
銀行振込	加盟店のチェックアウト画面で「9Pay」を支払い方法として選択すると、お客様は9Payの支払いページにリダイレクトされます。「銀行振込」を選択すると、銀行振込により支払いを完了することができます。

統合方式 #

支払い方法の列挙値： 9pay

9Payには2つの連携方法があります

ダイレクトAPI
チェックアウト

ダイレクト API #

支払いの流れ #

APIを直接連携する場合、OpenAPIで決済インテントを作成した後、顧客は9Payのログインページにリダイレクトされます。顧客は支払い方法を選択します

例えば、顧客は「9Pay」の電子ウォレットを選択します。その後、顧客はQRコードをスキャンして支払いを完了します。

その後、お客様はご指定いただいたページにリダイレクトされます。

統合の方法 #

直接APIを統合するには、PaymentIntentを作成し、1つのステップでURLを取得することができます。以下はペイメントインテントを作成するデモです：

PaymentIntentの作成

PaymentIntent は、顧客から支払いを回収する意図を表し、支払いプロセスのライフサイクルを追跡するオブジェクトです。サーバー上で PaymentIntent を作成し、回収金額と対応通貨を指定してください。すでに Payment Intents を統合している場合は、支払い方法の種類の一覧に 9pay を追加してください。

リクエスト

{
    "amount":10000,
    "currency":"VND",
    "confirm":true,
    "payment_method_data" : {
 "type":"9pay"
    },
    "return_url":"https://swooshtransfer.com/"
}

応答

{
    "id": "pi_1668947502776188928",
    "object": "payment_intent",
    "created": 1686743067000,
    "livemode": false,
    "currency": "VND",
    "amount": 10000,
    "status": "requires_action",
    "client_secret": "pi_1668947502776188928_secret_5eKUVX8MFLiS0nSMEG35YWDJ",
    "next_action": {
 "type": "9pay_handle_redirect",
 "9pay_handle_redirect": {
 "url": "https://sand-payment.9pay.vn/portal?baseEncode=eyJhbW91bnQiOiIxMDAwMCIsImN1cnJlbmN5IjoiVk5EIiwiZGVzY3JpcHRpb24iOiJkZXNjcmlwdGlvbiIsImludm9pY2Vfbm8iOiJjaF8xNjY4OTQ3NTAyOTAyMDE4MDQ4IiwibWVyY2hhbnRLZXkiOiJQVEpwOXUiLCJyZXR1cm5fdXJsIjoiaHR0cHM6Ly9hcGl0ZXN0Lndvb3NocGF5LmNvbS92MS9yZWNlaXZlcy9jMTEvcnVybCIsInRpbWUiOiIxNjg2NzQzMDY2In0=&signature=jhZPpXG1XQDVwnexSSnr0WQap2HpLx0NqeeY2NDj3kQ="
 }
    },
    "payment_method_types": [
 "9pay"
    ],
    "confirmation_method": "automatic",
    "return_url": "https://swooshtransfer.com/",
    "payment_method": "pm_1668947502629388288",
    "capture_method": "automatic"
}

チェックアウト #

支払いの流れ #

顧客は利用可能な支払い方法の一覧から「9Pay」を選択し、「支払う」ボタンをクリックします

お客様は9Payのログインページにリダイレクトされます

例えば、顧客は「9Pay」の電子ウォレットを選択します。その後、顧客はQRコードをスキャンして支払いを完了します。

その後、お客様はご指定いただいたページにリダイレクトされます。

セッションの作成 #

リクエスト

{
    "cancel_url": "https://swooshtransfer.com/",
    "mode": "payment",
    "success_url": "https://swooshtransfer.com/",
    "payment_method_types": [
 "9pay"
    ],
    "line_items": [
 {
 "price_data": {
 "currency": "VND",
 "product": null,
 "unit_amount": 10000,
                "active": true,
 "metadata": {
 "key1": "value1",
 "key2": "value2"
 },
                "nickname": "apple",
 "product_data": {
 "id": null,
 "name": "apple",
 "active": true,
 "description": "とてもおいしい",
                    "metadata": {
 "key1": "value1",
 "key2": "value2"
 },
 "url": "www.baidu.com"
                },
 "billing_scheme": "testscheme",
 "lookup_key": "test_lookup_key"
 },
 "quantity": 1
 }
    ]
}

応答

{
    "id": "cs_1668947425479360512",
    "object": "checkout.session",
    "created": 1686743048000,
    "livemode": false,
    "currency": "VND",
    "customer": "",
    "mode": "payment",
    "status": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1668947425479360512?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
    "cancel_url": "https://swooshtransfer.com/",
    "line_items": {
 "object": "list",
 "data": [
 {
 "id": "li_1668947425508720640",
                "object": "item",
 "currency": "VND",
                "description": "apple",
 "price": {
 "id": "price_1668947425533886464",
                    "object": "price",
 "created": 1686743048000,
 "livemode": false,
 "active": true,
 "currency": "VND",
                    "metadata": {
 "key1": "value1",
 "key2": "value2"
                    },
 "nickname": "apple",
 "product": {
 "id": "prod_1668947425546469376",
                        "object": "product",
 "created": 1686743048000,
 "livemode": false,
 "active": true,
 "description": "とてもおいしい",
                        "metadata": {
 "key1": "value1",
 "key2": "value2"
                        },
 "name": "apple",
 "url": "www.baidu.com",
 "updated": 1686743048000
 },
                    "type": "one_time",
 "unit_amount": 10000,
 "billing_scheme": "per_unit",
 "lookup_key": "test_lookup_key"
                },
 "数量": 1,
 "小計": 10000,
 "合計": 10000
            }
 ]
    },
    "payment_intent": "pi_1668947425710047232",
    "payment_method_types": [
 "9pay"
    ],
    "payment_status": "unpaid",
    "success_url": "https://swooshtransfer.com/",
    "amount_subtotal": 10000,
    "amount_total": 10000,
    "billing_address_collection": "auto",
    "expires_at": 1686829448437,
    "payment_link": "",
    "client_secret": "pi_1668947425710047232_secret_beZrT7mccYT27tC9ju0RbvlJ"
}