Giropay는 은행 간 시스템으로, 다음에서 도입했습니다. 의 2005년 독일 은행들이 온라인 뱅킹의 공식 결제 수단으로 채택했습니다. 4천만 명 이상의 쇼핑객이 이용하고 있으며 독일 내 모든 온라인 거래의 161조 4천억 달러를 차지합니다.
특징 #
사용 가능한 국가 코드 | DE |
---|---|
통화 처리 | EUR |
결제 통화 | EUR |
최소 거래 금액 | 1.00 EUR |
최대 거래 금액 | 제한 없음. 최대 10.000유로 - 결제 보장* 10.000유로 이상 - 지불이 보장되지 않음 |
환불 | ✅ |
부분 환불 | ✅ |
여러 차례 부분 환불 | ✅ |
차지백 | ❌ |
*기로페이는 계약상 최초 거래 후 최대 6주 동안 결제를 보증합니다.
통합 방법 #
결제 방법 열거 값입니다: Giropay
Giropay를 위한 통합 방법이 있습니다.
- 다이렉트 API
- 결제
직접 API #
통합하는 방법 #
직접 API 통합의 경우, 결제 인텐트를 생성하고 단 한 단계로 URL을 가져올 수 있습니다. 다음은 결제 인텐트 생성 데모입니다:
결제 인텐트는 고객으로부터 결제를 수금하려는 의도를 나타내며 결제 프로세스의 라이프사이클을 추적하는 객체입니다. 서버에서 결제 인텐트를 생성하고 수금할 금액과 지원 통화를 지정합니다. 기존 결제 인텐트 통합이 있는 경우 다음을 추가합니다. Giropay 를 결제수단 유형 목록에 추가합니다.
이 결제 방법을 사용하려면 다음에서 국가를 지정해야 합니다. 청구_세부정보.주소
국가 코드가 독일인 경우 DE
.
요청 결제 인텐트 생성
{
"금액": 2000,
"통화": "EUR",
"confirm": true,
"payment_method_data": {
"type": "giropay",
"청구_세부정보": {
"주소": {
"country": "DE"
},
"firstName": "",
"lastName": ""
}
},
"return_url": "https://wooshpay.com"
}
응답
{
"id": "pi_1670644604036186112",
"object": "payment_intent",
"created": 1687147687000,
"livemode": false,
"통화": "EUR",
"금액": 2000,
"status": "requires_action",
"client_secret": "pi_1670644604036186112_secret_9UHXdOLAE1WV7A1UCIjH8nMP",
"next_action": {
"type": "REDIRECT_TO_URL",
"GIOPAY_HANDLE_REDIRECT": {
"url": "https://r3.girogate.de/ti/simgiropay?tx=2090827518&rs=33tiT9GdES3vl4zIQ4ShK4Sw3NsvymQj&cs=0981d204f358af0d05ea4aa49a2b678fbe36aa4f13af2624441385921431f7a6"
}
},
"payment_method_types": [
"giropay"
],
"확인_방법": "automatic",
"return_url": "https://wooshpay.com",
"payment_method": "pm_1670644603939717120",
"capture_method": "automatic"
}
결제 #
결제 흐름 #
- 고객이 사용 가능한 결제 수단 목록에서 Giropay를 선택하고 결제 버튼을 클릭합니다.
- 고객은 Giropay 페이지로 리디렉션됩니다.
- 고객이 은행을 선택하고 온라인 뱅킹을 통해 결제를 승인합니다.
세션 만들기 #
요청 세션 만들기
{
"취소_URL": "www.wooshpay.com",
"mode": "결제",
"success_url": "https://wooshpay.com/",
"payment_method_types": [
"giropay"
],
"line_items": [
{
"price_data": {
"currency": "EUR",
"product": null,
"단위_금액": 2000,
"product_data": {
"name": "apple"
},
"billing_scheme": "testscheme",
"lookup_key": "test_lookup_key"
},
"수량": 1
}
]
}
응답
{
"id": "cs_1680883889586831360",
"객체": "checkout.session",
"created": 1689588923000,
"livemode": false,
"통화": "EUR",
"customer": "",
"모드": "결제",
"상태": "open",
"url": "https://checkouttest.wooshpay.com/pay/cs_test_1680883889586831360?key=pk_test_NTE2Njk1Mjk1ODMxNjAwMDQ2MDkxOmVqUkVxaWdMOVNQSGpRdmV0ZXUxZFBmcTE2ODY4ODE4NDY0MTg",
"취소_URL": "www.wooshpay.com",
"line_items": {
"object": "목록",
"데이터": [
{
"id": "li_1680883889620385792",
"object": "item",
"통화": "EUR",
"description": "apple",
"price": {
"id": "price_1680883889632968704",
"object": "가격",
"created": 1689588923000,
"livemode": false,
"active": false,
"통화": "EUR",
"product": {
"id": "prod_1680883889641357312",
"object": "제품",
"created": 1689588923000,
"livemode": false,
"active": false,
"name": "apple",
"updated": 1689588923000
},
"type": "one_time",
"단위_금액": 2000,
"billing_scheme": "단위당",
"lookup_key": "test_lookup_key"
},
"수량": 1,
"amount_subtotal": 2000,
"amount_total": 2000
}
]
},
"payment_intent": "pi_1680883889804935168",
"payment_method_types": [
"giropay"
],
"payment_status": "미지급",
"success_url": "https://wooshpay.com/",
"금액_소계": 2000,
"금액_총계": 2000,
"청구지_주소_수집": "auto",
"expires_at": 1689675323250,
"payment_link": "",
"client_secret": "pi_1680883889804935168_secret_oOaiHu8k190zNlX9zeIV5xkl"
}
다음 단계 #
필요에 따라 통합에 더 많은 기능을 추가할 수 있습니다.
웹훅 만들기 #
WooshPay 계정에서 이벤트를 수신하여 연동이 자동으로 반응을 트리거할 수 있도록 합니다. 활성화된 이벤트와 URL에 주로 초점을 맞춘 웹훅을 생성합니다.
환불 생성 #
환불을 생성하여 고객에게 금액을 상환합니다. 부분 환불도 수행할 수 있지만 모든 결제 방법에서 부분 환불을 지원하는 것은 아닙니다. 부분 환불은 원래 거래 금액의 일부만 환불하는 것입니다.