중국 고객들에게 인기 있는 디지털 지갑인 Alipay에 대해 알아보세요. #
Alipay는 전 세계 10억 명 이상의 활성 사용자를 보유한 중국의 디지털 지갑입니다. 알리페이 사용자는 로그인 자격증명 또는 알리페이 앱을 사용하여 웹이나 모바일 장치에서 결제할 수 있습니다. Alipay는 고객의 로그인 자격 증명을 사용하여 결제를 인증하기 때문에 분쟁 발생률이 낮고 사기를 줄일 수 있습니다.
특징 #
| 고객 위치 | 중국 소비자 화교 중국인 여행자 |
|---|---|
| 통화 처리 | CNY, GBP, USD, EUR, HKD |
| 결제 통화 | GBP, HKD, EUR |
| 최소 거래 금액 | 0.01 CNY |
| 최대 거래 금액 | 제한 없음 |
| 환불 | ✅ |
| 부분 환불 | ✅ |
| 여러 차례 부분 환불 | ❌ |
| 차지백 | ❌ |
금지된 비즈니스 카테고리 WooshPay와 알리페이 플러스 모두 서비스 이용이 금지된 업체 목록을 관리하고 있습니다. WooshPay에서 알리페이 플러스를 사용하려면 귀하의 비즈니스가 알리페이의 사용 금지 비즈니스 목록에 포함되거나 사용이 제한되어서는 안 됩니다. 귀하의 비즈니스가 금지 비즈니스에 해당하는지 확실하지 않거나 이러한 요건이 귀하에게 어떻게 적용되는지 궁금한 점이 있으면 다음 연락처로 문의하시기 바랍니다. support@wooshpay.com.
하위 제품 #
| 제품 | 결제 시나리오 설명 |
|---|---|
| 웹 결제 | 데스크톱 브라우저에서 결제 수단 판매자 결제로 Alipay를 선택하면 QR 코드가 표시됩니다. 그런 다음 구매자는 휴대폰에서 Alipay 앱을 열고 브라우저 페이지에 표시된 바코드를 스캔하여 결제를 완료합니다. |
| 앱 결제 | 모바일 브라우저에서 쇼핑객이 판매자 결제 시 결제 수단으로 알리페이를 선택하면 브라우저에서 알리페이 앱으로 리디렉션되어 결제를 완료한 후 판매자 브라우저로 다시 리디렉션됩니다. |
결제 흐름 #
웹 결제 #
앱 결제 #
통합 방법 #
결제 방법 열거 값입니다: alipay
알리페이에는 두 가지 통합 방법이 있습니다.
- 다이렉트 API
- 결제
| 통합 방법 | 결제 시나리오 | terminal_type 열거형 값 |
|---|---|---|
| 다이렉트 API | 웹 결제 | 웹 |
| 다이렉트 API | 앱 결제 | 앱 |
| 결제 | 웹 결제 | 이 경우 터미널 유형 를 입력합니다. 결제 시 기기에 따라 자동으로 QR 코드가 생성되거나 Alipay 앱으로 리디렉션됩니다. |
| 결제 | 앱 결제 | 이 경우 터미널 유형 를 입력합니다. 결제 시 기기에 따라 자동으로 QR 코드가 생성되거나 Alipay 앱으로 리디렉션됩니다. |
다이렉트 API #
결제 인텐트는 고객으로부터 결제를 수금하려는 의도를 나타내며 결제 프로세스의 라이프사이클을 추적하는 객체입니다. 서버에서 결제 인텐트를 생성하고 수금할 금액과 지원되는 통화를 지정하세요.
결제 인텐트 생성 #
직접 API 통합의 경우, 결제 인텐트를 생성하고 단 한 단계로 URL을 가져올 수 있습니다. 다음은 결제 인텐트 생성 데모입니다:
- 웹 결제
- 앱 결제
단말기 유형의 열거 값을 변경하여 결제 의도에서 생성된 결제 시나리오를 제어할 수 있습니다.payemen_method_options.alipay.terminal_type
웹 결제 #
요청
{
"금액": 20,
"통화": "CNY",
"confirm": true,
"payment_method_options": {
"alipay": {
"client_ip": "192.168.0.1",
"terminal_type": "WEB",
"os_type": "IOS"
}
},
"payment_method_data": {
"type": "alipay"
},
"payment_method_types": [
"alipay"
],
"return_url": "https://wooshpay.com"
}응답
{
"id": "pi_1666729870215872512",
"object": "payment_intent",
"created": 1686214342000,
"통화": "CNY",
"금액": 20,
"status": "requires_action",
"livemode": true,
"client_secret": "pi_1666729870215872512_secret_jmGL6NBNInPx5zdjIJ2utli4",
"next_action": {
"type": "REDIRECT_TO_URL",
"alipay_handle_redirect": {
"url": "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=28166604009zSv0130nTr0bKfhzSwT08YvSW"
}
},
"payment_method_types": [
"alipay"
],
"confirmation_method": "automatic",
"결제_방법_옵션": {
"alipay": {
"terminal_type": "WEB",
"os_type": "IOS",
"client_ip": "192.168.0.1"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1666729870102626304",
"capture_method": "automatic"
}The url 에서 next_action을 열 수 있으며, 링크에서 고객이 Alipay의 결제 페이지로 리디렉션됩니다. 고객은 QR 코드를 스캔하거나 지갑에 로그인하여 결제할 수 있습니다.
앱 결제 #
요청
{
"금액": 20,
"통화": "CNY",
"confirm": true,
"payment_method_options": {
"alipay": {
"client_ip": "192.168.0.1",
"terminal_type": "APP",
"os_type": "IOS"
}
},
"payment_method_data": {
"type": "alipay"
},
"payment_method_types": [
"alipay"
],
"return_url": "https://wooshpay.com"
}응답
{
"id": "pi_1666732544285999104",
"object": "payment_intent",
"created": 1686214980000,
"currency": "CNY",
"amount": 20,
"status": "requires_action",
"livemode": true,
"client_secret": "pi_1666732544285999104_secret_NRUV59FL6qtFyz2bXVeDyLD4",
"next_action": {
"type": "redirect_to_url",
"alipay_handle_redirect": {
"url": "https://render.alipay.com/p/s/i/?scheme=alipays%3A%2F%2Fplatformapi%2FstartApp%3FappId%3D10000007%26actionType%3Droute%26qrcode%3D281666040092tD6e6GlEzzTlQl6HrEqv3kOI%26externalThrough%3D%257B%2522acTerminalType%2522%253A%2522WAP%2522%257D"
}
},
"payment_method_types": [
"alipay"
],
"confirmation_method": "automatic",
"payment_method_options": {
"alipay": {
"terminal_type": "APP",
"os_type": "IOS",
"client_ip": "192.168.0.1"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1666732544155975680",
"capture_method": "automatic"
}결제 #
Alipay 결제를 지원하려면 결제 세션이 다음 조건을 모두 충족해야 합니다:
- 모든 품목의 가격은 동일한 통화로 표시되어야 합니다. 서로 다른 통화로 된 품목이 있는 경우 각 통화에 대해 별도의 결제 세션을 생성합니다.
- 일회성 줄 항목만 사용할 수 있습니다.
결제 수단으로 Alipay 활성화
새 결제 세션을 생성할 때는 다음을 수행해야 합니다:
목록에 알리페이 플러스를 추가합니다. 결제 방법 유형. 모든 라인 항목 동일한 통화를 사용합니다.
세션 만들기 #
이 경우 터미널 유형 를 입력합니다. 결제 시 기기에 따라 자동으로 QR 코드가 생성되거나 Alipay 앱으로 리디렉션됩니다.
요청
{
"취소_URL": "www.baidu.com",
"mode": "결제",
"success_url": "https://wooshpay.com/",
"payment_method_types": [
"alipay"
],
"line_items": [
{
"price_data": {
"통화": "CNY",
"단위_금액": 100000,
"active": true,
"product_data": {
"name": "대만 펑리"
},
"billing_scheme": "testscheme",
"lookup_key": "test_lookup_key"
},
"수량": 1
}
]
}응답
{
"id": "cs_1666733999608823808",
"객체": "checkout.session",
"created": 1686215327000,
"통화": "CNY",
"customer": "",
"mode": "결제",
"livemode": true,
"status": "open",
"url": "https://checkout.wooshpay.com/pay/cs_1666733999608823808?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
"취소_URL": "www.baidu.com",
"line_items": {
"object": "목록",
"데이터": [
{
"id": "li_1666733999642378240",
"object": "item",
"통화": "CNY",
"설명": "대만 펑리",
"price": {
"id": "price_1666733999659155456",
"object": "가격",
"created": 1686215327000,
"active": true,
"통화": "CNY",
"product": {
"id": "prod_1666733999675932672",
"object": "제품",
"created": 1686215327000,
"active": true,
"name": "대만 펑리",
"livemode": true,
"updated": 1686215327000
},
"type": "one_time",
"livemode": true,
"단위_금액": 100000,
"billing_scheme": "per_unit",
"lookup_key": "test_lookup_key"
},
"수량": 1,
"amount_subtotal": 100000,
"amount_total": 100000
}
]
},
"payment_intent": "pi_1666733999864676352",
"payment_method_types": [
"alipay"
],
"payment_status": "미지급",
"success_url": "https://wooshpay.com/",
"금액_소계": 100000,
"금액_총계": 100000,
"청구지_주소_수집": "auto",
"expires_at": 1686301726587,
"payment_link": "",
"client_secret": "pi_1666733999864676352_secret_5S1FMaseZU6gfIZjl2QlOdY7"
}The url 에서 next_action을 열 수 있으며, 링크에서 고객이 Alipay의 결제 페이지로 리디렉션됩니다. 고객은 QR 코드를 스캔하거나 지갑에 로그인하여 결제할 수 있습니다.
다음 단계 #
필요에 따라 통합에 더 많은 기능을 추가할 수 있습니다.
웹훅 만들기 #
WooshPay 계정에서 이벤트를 수신하여 연동이 자동으로 반응을 트리거할 수 있도록 합니다. 활성화된 이벤트와 URL에 주로 초점을 맞춘 웹훅을 생성합니다.
환불 생성 #
환불을 생성하여 고객에게 금액을 상환합니다. 부분 환불도 수행할 수 있지만 모든 결제 방법에서 부분 환불을 지원하는 것은 아닙니다. 부분 환불은 원래 거래 금액의 일부만 환불하는 것입니다.
