알리페이 플러스 결제 #
Alipay Plus는 동남아시아 및 중국 고객에게 서비스를 제공하는 중국의 디지털 지갑입니다. Alipay Plus 사용자는 로그인 자격 증명 또는 Alipay Plus에서 지원하는 특정 앱을 사용하여 웹 또는 모바일 장치에서 결제할 수 있습니다.
특성 #
고객 위치
- 중국 소비자
- 화교
- 중국인 여행자
- 동남아시아 소비자
프레젠테이션 통화
CNY, HKD, GBP, IDR, MYR, PHP, THB
지갑 목록
- AlipayHK
- DANA
- TNG
- BPI
- 래빗 라인 페이
- GCash
- 부스트
- 아쿨라쿠 페이레이트
금지된 비즈니스 카테고리
WooshPay와 알리페이 플러스 모두 서비스 사용이 금지된 비즈니스 목록을 관리하고 있습니다. WooshPay에서 Alipay Plus를 사용하려면 비즈니스가 Stripe 사용 제한을 받거나 Alipay의 금지 비즈니스 목록에 표시되어서는 안 됩니다. 귀하의 비즈니스가 금지 비즈니스에 해당하는지 확실하지 않거나 이러한 요구 사항이 귀하에게 어떻게 적용되는지 궁금한 점이 있는 경우 support@wooshpay.com 으로 문의하시기 바랍니다.
서버 간 통합 #
알리페이 플러스를 사용하면 고객이 웹사이트나 앱에서 리디렉션하여 결제하고, 다른 지갑을 통해 결제를 승인한 다음 웹사이트나 앱으로 돌아와 결제 성공 또는 실패 여부를 즉시 알림으로 확인할 수 있습니다.
개요 #
API 직접 연동의 경우, 결제 인텐트를 생성하고 URL을 가져오는 과정을 한 단계로 단축할 수 있으며, 아래는 결제 인텐트 생성 데모입니다:
- 결제 의도 생성
- 환불
- 웹훅
1. 결제 인텐트 생성 #
결제 인텐트는 고객으로부터 결제를 수금하려는 의도를 나타내며 결제 프로세스의 수명 주기를 추적하는 객체입니다. 서버에서 결제 인텐트를 생성하고 수금할 금액과 지원 통화를 지정합니다. 기존 결제 인텐트 연동이 있는 경우 결제 방법 유형 목록에 alipayplus를 추가합니다.
요청 결제 인텐트 생성
{
"금액":200,
"currency":"IDR", //다른 통화는 다른 지갑을 초래할 수 있습니다.
"confirm":true,
"payment_method_options":{
"alipayplus":{
"terminal_type":"WEB"
}
},
"payment_method_data":{
"type":"alipayplus"
},
"return_url":"https://wooshpay.com"
}응답
{
"id": "pi_1646355176136638464",
"object": "payment_intent",
"created": 1681356636000,
"통화": "IDR",
"금액": 200,
"status": "requires_action",
"livemode": true,
"client_secret": "pi_1646355176136638464_secret_gxkV1LYb76c2nFvtzDmHevyw",
"next_action": {
"alipayplus_handle_redirect": {
"normalUrl": "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040092tDht8YNMR2t2u648Mu5v476I"
}
},
"결제수단_유형": [
"alipay",
"위챗페이",
"card",
"alipayplus"
],
"확인_방법": "자동",
"결제_방법_옵션": {
"alipayplus": {
"terminal_type": "WEB"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1646355176006615040",
"capture_method": "automatic"
}의 normalUrl next_action 을 열면 링크에서 통화에 따라 다른 지갑이 표시되며, 고객은 QR 코드를 스캔하거나 지갑에 로그인하여 원하는 지갑을 선택하여 결제할 수 있습니다.
2. 환불 #
API 또는 대시보드를 사용하여 결제에 성공한 금액의 일부 또는 전액을 환불할 수 있습니다. 모든 환불 목록을 보려면 대시보드의 환불된 결제 페이지로 이동하세요.
API를 사용하여 결제를 환불하려면 결제 인텐트를 제공하는 환불을 생성합니다.
요청 환불 생성
{
"reason":"requested_by_customer",
"payment_intent":"pi_1575055712604651520"
}응답
{
"id":"re_1575092157281206272",
"object":"refund",
"created":1664366209000,
"amount":20,
"currency":"CNY",
"메타데이터":null,
"reason":"requested_by_customer",
"status":"성공",
"description":null,
"payment_intent":"pi_1575055712604651520",
"failure_reason":null
}3. 웹훅 #
WooshPay 계정에서 이벤트를 수신하여 통합이 자동으로 반응을 트리거할 수 있도록 하세요. 주로 다음 사항에 초점을 맞춘 웹훅을 만듭니다. enabled_events 그리고 url.
웹훅을 수신하는 단계:
- 모니터링하려는 이벤트와 구문 분석할 이벤트 페이로드를 식별합니다.
- 로컬 서버에서 웹훅 엔드포인트를 HTTP 엔드포인트(URL)로 만듭니다.
- 웹훅 엔드포인트가 제대로 작동하는지 테스트하고 콜백을 받았는지 확인합니다.
요청
{
"url":"https://apitest.wooshpay.com/v1/receives",
"description":"I_am_description",
"enabled_events":[
"payment_intent.created",
"payment_intent.payment_failed",
"payment_intent.succeeded",
"charge.refund.updated"
],
"api_version":"1.0.1"
}응답
{
"id":"we_1575093135514533888",
"object":"webhook_endpoint",
"created":1664366442000,
"description":"I_am_description",
"메타데이터":null,
"status":"enabled",
"url":"https://apitest.wooshpay.com/v1/receives",
"livemode":false,
"api_version":"1.0.1",
"enabled_events":[
"payment_intent.created",
"payment_intent.payment_failed",
"payment_intent.succeeded",
"charge.refund.updated"
]
}결제 #
알리페이플러스 결제를 지원하려면 결제 세션이 다음 조건을 모두 충족해야 합니다:
- 모든 품목의 가격은 동일한 통화로 표시되어야 합니다.
여러 통화로 된 품목이 있는 경우 각 통화에 대해 별도의 결제 세션을 생성합니다. - 일회성 줄 항목만 사용할 수 있습니다.
결제 수단으로 알리페이 플러스 사용 설정하기 #
새 결제 세션을 생성할 때는 다음을 수행해야 합니다:
목록에 알리페이 플러스를 추가합니다. 결제 방법 유형.
모든 라인 항목 동일한 통화를 사용합니다.
요청 세션 만들기
{
"취소_URL": "www.baide.com",
"모드": "결제",
"success_url": "www.wooshpay.com",
"payment_method_options": { //알리페이플러스를 결제 수단으로 추가
"alipayplus": {
"terminal_type": "WEB"
}
},
"line_items": [
{
"price_data": {
"currency": "GBP",
"product": null,
"단위_금액": 5,
"active": true,
"메타데이터": {
"key1": "value1",
"key2": "value2"
},
"닉네임": "fengli",
"product_data": {
"id": null,
"name": "대만 펑리",
"active": true,
"설명": "매우 맛있다",
"메타데이터": {
"key1": "value1",
"key2": "value2"
},
"url": "www.baidu.com"
},
"billing_scheme": "testscheme",
"조회_키": "test_lookup_key"
},
"수량": 1
}
]
}응답
{
"id": "cs_1597163428114333696",
"객체": "checkout.session",
"created": 1669628410000,
"통화": "GBP",
"customer": "",
"mode": "결제",
"livemode": true,
"shipping": null,
"상태": "open",
"url": "https://checkout.wooshpay.com/pay/cs_1597163428114333696?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
"cancel_url": "www.baidu.com",
"client_reference_id": null,
"customer_email": null,
"line_items": {
"object": "목록",
"데이터": [
{
"id": "li_1597163428139499520",
"object": "item",
"통화": "GBP",
"description": "대만 펑리",
"price": {
"id": "price_1597163428152082432",
"object": "가격",
"created": 1669628410000,
"active": true,
"통화": "GBP",
"메타데이터": {
"key1": "value1",
"key2": "value2"
},
"닉네임": "fengli",
"product": {
"id": "prod_1597163428164665344",
"object": "제품",
"created": 1669628410000,
"active": true,
"설명": "매우 맛있다",
"메타데이터": {
"key1": "value1",
"key2": "value2"
},
"name": "대만 펑리",
"livemode": true,
"url": "www.baidu.com",
"updated": 1669628410000,
"images": null
},
"type": "one_time",
"livemode": true,
"단위_금액": 5,
"청구_체계": "단위당",
"조회_키": "test_lookup_key"
},
"수량": 1,
"amount_subtotal": 5,
"amount_total": 5
}
],
"url": null,
"has_more": null
},
"payment_intent": "pi_1597163428336631808",
"payment_method_types": null,
"결제_상태": "미결제",
"success_url": "www.wooshpay.com",
"금액_소계": 5,
"금액_총계": 5,
"청구지_주소_수집": "auto",
"expires_at": 1669714809783,
"payment_link": "",
"결제_방법_옵션": null,
"전화번호_수집": null,
"배송지_주소_수집": null,
"client_secret": "pi_1597163428336631808_secret_pxwFDDYAbSnC99NpAKVwE1Sr"
}URL을 통해 WooshPay의 결제 페이지로 이동하면 통화에 따라 다른 지갑이 표시되며, 고객은 QR 코드를 스캔하거나 지갑에 로그인하여 원하는 지갑을 선택하여 결제할 수 있습니다.
