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에 주로 초점을 맞춘 웹훅을 생성합니다.
환불 생성 #
환불을 생성하여 고객에게 금액을 상환합니다. 부분 환불도 수행할 수 있지만 모든 결제 방법에서 부분 환불을 지원하는 것은 아닙니다. 부분 환불은 원래 거래 금액의 일부만 환불하는 것입니다.
