기로페이

Giropay는 은행 간 시스템으로, 다음에서 도입했습니다. 2005년 독일 은행들이 온라인 뱅킹의 공식 결제 수단으로 채택했습니다. 4천만 명 이상의 쇼핑객이 이용하고 있으며 독일 내 모든 온라인 거래의 161조 4천억 달러를 차지합니다.

특징 #

사용 가능한 국가 코드DE
통화 처리EUR
결제 통화EUR
최소 거래 금액1.00 EUR
최대 거래 금액제한 없음.
최대 10.000유로 - 결제 보장*
10.000유로 이상 - 지불이 보장되지 않음
환불
부분 환불
여러 차례 부분 환불
차지백

*기로페이는 계약상 최초 거래 후 최대 6주 동안 결제를 보증합니다.

통합 방법 #

결제 방법 열거 값입니다: Giropay

Giropay를 위한 통합 방법이 있습니다.

  1. 다이렉트 API
  2. 결제

직접 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"
}

결제 #

결제 흐름 #

  1. 고객이 사용 가능한 결제 수단 목록에서 Giropay를 선택하고 결제 버튼을 클릭합니다.
下载.png
  1. 고객은 Giropay 페이지로 리디렉션됩니다.
下载 (1).png
  1. 고객이 은행을 선택하고 온라인 뱅킹을 통해 결제를 승인합니다.
下载 (2).png
下载 (3).png

세션 만들기 #

요청 세션 만들기

{
    "취소_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에 주로 초점을 맞춘 웹훅을 생성합니다.

환불 생성 #

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

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