鲲

한국어
한국어 English 简体中文 日本語 Español Português do Brasil Italiano Français
로그인

9Pay

목차

베트남 고객들에게 인기 있는 디지털 지갑인 9Pay에 대해 알아보세요. #

수백만 명이 넘는 사용자를 보유한 9Pay는 베트남의 선도적인 디지털 지갑으로, 개인의 다양한 결제 요구를 충족합니다. 일상적인 사용을 위한 다양하고 편리한 기능을 제공하는 올인원 앱입니다.

특징 #

통화 처리VND
결제 통화USD
최소 거래 금액현지 직불 카드 최소: 10,000 VND
국제 카드 최소: 10,000 VND
9Pay 전자 지갑 최소: 5,000 VND
은행 송금 최소: 10,000 VND
최대 거래 금액현지 직불 카드 최대: 200,000,000 VND
국제 카드 최대 : 200,000,000 VND
9Pay 전자 지갑 최대: 100,000,000 VND
은행 송금 최대: 제한 없음
환불✅
부분 환불✅
여러 차례 부분 환불✅
차지백✅

하위 제품 #

제품설명
9Pay 전자 지갑판매자 결제에서 9Pay를 결제 수단으로 선택하면 고객은 9Pay 결제 페이지로 리디렉션됩니다. 그런 다음 9Pay 전자지갑을 선택하면 QR코드가 나타납니다. 그런 다음 구매자는 휴대폰에서 9Pay 앱을 열고 브라우저 페이지에 표시된 바코드를 스캔하여 결제를 완료합니다.
현지 직불 카드판매자 결제에서 9Pay를 결제 수단으로 선택하면 고객은 9Pay 결제 페이지로 리디렉션됩니다. 그런 다음 현지 직불카드와 현지 은행명을 선택하고 카드 정보를 입력하면 결제가 완료됩니다.
국제 카드판매자 결제에서 9Pay를 결제 수단으로 선택하면 고객은 9Pay 결제 페이지로 리디렉션됩니다. 결제 수단으로 해외 카드를 선택합니다. 카드 정보를 입력하면 결제가 완료됩니다.
은행 송금판매자 결제에서 9Pay를 결제 수단으로 선택하면 고객은 9Pay 결제 페이지로 리디렉션됩니다. 은행 송금을 선택하면 은행 송금으로 결제를 완료할 수 있습니다.

통합 방법 #

결제 방법 열거 값입니다: 9pay

9Pay에는 두 가지 통합 방법이 있습니다.

  1. 다이렉트 API
  2. 결제

직접 API #

결제 흐름 #

  1. API 직접 연동의 경우, OpenAPI로 결제 의도를 생성한 후 고객이 9Pay 로그인 페이지로 리디렉션됩니다. 고객이 결제수단을 선택합니다.
Untitled.png
  1. 예를 들어 고객이 9Pay 전자지갑을 선택합니다. 그런 다음 고객이 QR 코드를 스캔하여 결제를 완료합니다.
Untitled1.png
  1. 그 후에는 고객이 지정한 페이지로 리디렉션됩니다.

통합하는 방법 #

직접 API 통합의 경우, 결제 인텐트를 생성하고 단 한 단계로 URL을 가져올 수 있습니다. 다음은 결제 인텐트 생성 데모입니다:

결제 인텐트 생성

결제 인텐트는 고객으로부터 결제를 수금하려는 의도를 나타내며 결제 프로세스의 수명 주기를 추적하는 객체입니다. 서버에서 결제 인텐트를 생성하고 수금할 금액과 지원 통화를 지정합니다. 기존 결제 인텐트 연동이 있는 경우 결제 방법 유형 목록에 9pay를 추가합니다.

요청

{
    "금액":10000,
    "통화":"VND",
    "confirm":true,
    "payment_method_data" : {
        "type":"9pay"
    },
    "return_url":"https://swooshtransfer.com/"
}

응답

{
    "id": "pi_1668947502776188928",
    "object": "payment_intent",
    "created": 1686743067000,
    "livemode": false,
    "통화": "VND",
    "금액": 10000,
    "상태": "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="
        }
    },
    "결제수단_유형": [
        "9pay"
    ],
    "confirmation_method": "자동",
    "return_url": "https://swooshtransfer.com/",
    "payment_method": "pm_1668947502629388288",
    "capture_method": "automatic"
}

결제 #

결제 흐름 #

  1. 고객이 사용 가능한 결제 수단 목록에서 9Pay를 선택하고 결제 버튼을 클릭합니다.
9078ac1b-6da0-4dd7-8641-03e2206015b3.png
  1. 고객은 9Pay 로그인 페이지로 리디렉션됩니다.
Untitled.png
  1. 예를 들어 고객이 9Pay 전자지갑을 선택합니다. 그런 다음 고객이 QR 코드를 스캔하여 결제를 완료합니다.
Untitled1.png
  1. 그 후에는 고객이 지정한 페이지로 리디렉션됩니다.

세션 만들기 #

요청

{
    "취소_URL": "https://swooshtransfer.com/",
    "모드": "결제",
    "success_url": "https://swooshtransfer.com/",
    "payment_method_types": [
        "9pay"
    ],
    "line_items": [
        {
            "price_data": {
                "currency": "VND",
                "product": null,
                "단위_금액": 10000,
                "active": true,
                "메타데이터": {
                    "key1": "value1",
                    "key2": "value2"
                },
                "닉네임": "apple",
                "product_data": {
                    "id": null,
                    "name": "apple",
                    "active": true,
                    "설명": "매우 맛있다",
                    "메타데이터": {
                        "key1": "value1",
                        "key2": "value2"
                    },
                    "url": "www.baidu.com"
                },
                "billing_scheme": "testscheme",
                "조회_키": "test_lookup_key"
            },
            "수량": 1
        }
    ]
}

응답

{
    "id": "cs_1668947425479360512",
    "객체": "checkout.session",
    "created": 1686743048000,
    "livemode": false,
    "통화": "VND",
    "customer": "",
    "모드": "결제",
    "상태": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1668947425479360512?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
    "cancel_url": "https://swooshtransfer.com/",
    "line_items": {
        "object": "목록",
        "data": [
            {
                "id": "li_1668947425508720640",
                "object": "item",
                "통화": "VND",
                "설명": "사과",
                "price": {
                    "id": "price_1668947425533886464",
                    "object": "가격",
                    "created": 1686743048000,
                    "livemode": false,
                    "active": true,
                    "통화": "VND",
                    "메타데이터": {
                        "key1": "value1",
                        "key2": "value2"
                    },
                    "닉네임": "apple",
                    "product": {
                        "id": "prod_1668947425546469376",
                        "object": "제품",
                        "created": 1686743048000,
                        "livemode": false,
                        "active": true,
                        "설명": "매우 맛있다",
                        "메타데이터": {
                            "key1": "value1",
                            "key2": "value2"
                        },
                        "name": "apple",
                        "url": "www.baidu.com",
                        "updated": 1686743048000
                    },
                    "type": "one_time",
                    "단위_금액": 10000,
                    "billing_scheme": "단위당",
                    "조회_키": "test_lookup_key"
                },
                "수량": 1,
                "amount_subtotal": 10000,
                "amount_total": 10000
            }
        ]
    },
    "payment_intent": "pi_1668947425710047232",
    "payment_method_types": [
        "9pay"
    ],
    "payment_status": "미결제",
    "success_url": "https://swooshtransfer.com/",
    "금액_소계": 10000,
    "금액_총액": 10000,
    "청구지_주소_수집": "auto",
    "expires_at": 1686829448437,
    "payment_link": "",
    "client_secret": "pi_1668947425710047232_secret_beZrT7mccYT27tC9ju0RbvlJ"
}

다음 단계 #

필요에 따라 통합에 더 많은 기능을 추가할 수 있습니다.

웹훅 만들기 #

WooshPay 계정에서 이벤트를 수신하여 연동이 자동으로 반응을 트리거할 수 있도록 합니다. 활성화된 이벤트와 URL에 주로 초점을 맞춘 웹훅을 생성합니다.

환불 생성 #

환불을 생성하여 고객에게 금액을 상환합니다. 부분 환불도 수행할 수 있지만 모든 결제 방법에서 부분 환불을 지원하는 것은 아닙니다. 부분 환불은 원래 거래 금액의 일부만 환불하는 것입니다.

어떤 느낌인가요?
2023년 8월 8일에 업데이트됨