インドネシアのお客様に人気のデジタルウォレット、DANAについてご紹介します。 #
DANAは3,000万人以上のユーザーを持つインドネシアのデジタルウォレット。日常生活においてキャッシュレス、カードレスで安全に支払いができるオールインワンアプリである。DANAを使えば、オンライン、店舗での支払い、モバイルトップアップや請求書払いが可能です。
特徴 #
通貨の処理 | IDR |
---|---|
決済通貨 | 米ドル |
最低取引額 | 100 IDR |
最大取引額 | 300,000,000ドル |
払い戻し | ✅ |
一部払い戻し | ✅ |
複数回の一部払い戻し | ❌ |
チャージバック | ❌ |
統合方式 #
支払い方法の列挙値: ダナ
DANAには2つの統合方法がある。
- ダイレクトAPI
- チェックアウト
ダイレクト API #
支払いの流れ #
- 直接API統合の場合、OpenAPIで支払いインテントを作成した後、顧客はDANAのログインページにリダイレクトされます。
- お客様がDANAアカウントにログインし、お支払いを完了します。
- 支払いは成功し、クライアントは指定したページにリダイレクトされます。
統合の方法 #
直接APIを統合するには、PaymentIntentを作成し、1つのステップでURLを取得することができます。以下はペイメントインテントを作成するデモです:
PaymentIntentは、顧客から支払いを収集する意図を表すオブジェクトで、支払いプロセスのライフサイクルを追跡します。サーバーにPaymentIntentを作成し、収集する金額とサポートする通貨を指定します。既存のPaymentIntentの統合がある場合は、支払い方法の種類のリストにdanaを追加します。
リクエスト
{
"金額": 100、
"通貨": "IDR"、
"confirm":true、
"payment_method_data" : { { "タイプ": "dana".
"タイプ": "dana"
},
"return_url": "https://your.website"
}
応答
{
"id": "pi_1646356544343769088",
"object": "payment_intent",
"created": 1681356963000,
"currency": "IDR",
"amount": 100,
"status": "requires_action",
"livemode": true,
"client_secret": "pi_1646356544343769088_secret_m58mCj87dL3cj5JiUOtbdx2e",
"next_action": {
"type": "redirect_to_url",
"dana_handle_redirect": {
"url": "https://m.dana.id/m/portal/cashier/checkout?bizNo=20230413111212800110166041377848845×tamp=1681356963277&originSourcePlatform=IPG&mid=216620000562418247453&sign=LY3%2FomMnXVJqk9uEOZJopCnSb%2FBDk64I9nIhBZdHc3wi%2Fo%2BcIVCBmCWTacAxHv%2BAKV0auNlCbkyrKvdK2B1X7aoiDv2dxO%2BAfdc7dkmny4FzOJ%2BrxNBmWerSkoexkEw1u52TMIWwLnDzwXYiGTsrs%2Bhzkew4okaJ2w9i4hMJh%2FLDRym0XwYaX9h7N0MCkrXYNY%2FfrEdY8BW%2BazU2wYWdDH%2B4fkgSs7D9YxXj%2Fu2eon2JaGuWYht93piOji22pGW9hD1ubH1vi4lZwFfp96Lp1fsgzV2uvRv6d8CTXSQw%2Fg9oeI3jFXw1bHqBZocv51QZl3AfKvXauWBSVClj4CziDw%3D%3D&forceToH5=false"
}
},
"payment_method_types": [
"dana"
],
"confirmation_method": "automatic",
"return_url": "https://your.website",
"payment_method": "pm_1646356544205357056",
"capture_method": "automatic"
}
チェックアウト #
支払いの流れ #
- 利用可能な支払い方法のリストからDANAを選択し、「Pay」ボタンをクリックします。
- お客様はDANAのログインページにリダイレクトされます。
- お客様がDANAアカウントにログインし、お支払いを完了します。
- 支払いは成功し、クライアントは指定したページにリダイレクトされます。
セッションの作成 #
リクエスト
{
"cancel_url":"www.wooshpay.com"、
"mode":「支払い」、
"success_url":"https://wooshpay.com/"、
"payment_method_types":[
"dana"
],
"line_items":[
{
"price_data":{
"currency":"IDR"、
"unit_amount":20000,
"ニックネーム":"apple"、
"product_data":{
"name":"アップル"
},
"billing_scheme":"testscheme"、
「lookup_key":"test_lookup_key"
},
「数量":1
}
]
}
応答
{
"id":"cs_1676131330724724736",
"オブジェクト":"checkout.session"、
"created":1688455825000,
"livemode": false、
「通貨":「IDR"、
"顧客":"",
「mode":「支払い
"status":「オープン
"url":"https://checkouttest.wooshpay.com/pay/cs_test_1676131330724724736?key=pk_test_NTE2MjA5NzY5MzgxOTk5NDUyMTYxOnhXNjdQQ3JndjBVZ04wcVVwNk5yaG9PdjE2NzUzMDU5OTc0NTI"、
"cancel_url":"www.wooshpay.com"、
「line_items":{
"object":"リスト"、
"data":[
{
"id":"li_1676131330754084864",
"object":"item": "アイテム"、
"currency":「IDR"、
"説明":"リンゴ"、
「価格":{
"id":"price_1676131330766667776",
"object":"価格"、
"created":1688455825000,
「livemode": false、
「active": true、
「通貨":「IDR"、
「ニックネーム":"アップル"、
"product":{
"id":"prod_1676131330783444992",
"object":"product"、
"created":1688455825000,
"livemode": false、
「active": true、
"name":"apple"、
"更新":1688455825000
},
"type":"one_time"、
"unit_amount":20000,
「課金方式":"per_unit"、
"lookup_key":"test_lookup_key"
},
"quantity":1,
「amount_subtotal": 20000、
「金額_合計": 20000
}
]
},
"payment_intent":"pi_1676131330947022848",
"payment_method_types":[
"dana"
],
"payment_status":「未払い
"success_url":"https://wooshpay.com/"、
"amount_subtotal": 20000、
"amount_total": 20000、
"billing_address_collection":"自動"、
"expires_at":1688542224918,
"payment_link":"",
"client_secret": "pi_1676131330947022848_secret_ENUbfvBKA7zljcENnlrG3K7q"
}
次のステップ #
必要に応じて、統合にさらに機能を追加することができます。
ウェブフックの作成 #
統合が自動的にリアクションをトリガーできるように、WooshPayアカウントのイベントをリッスンします。enabled_eventsとurlにフォーカスしたWebhookを作成します。
払い戻しの作成 #
顧客に資金を返済するために返金を作成します。部分払い戻しを行うこともできますが、すべての支払い方法が対応しているわけではありません。部分払い戻しとは、元の取引金額の一部のみを払い戻すことです。