프롬프트페이

태국에서 인기 있는 즉시 송금 서비스인 PromptPay에 대해 알아보세요.

프롬프트페이는 결제 정책 결정 기관인 태국 중앙은행(BoT)이 개발하고 규제하는 인프라 솔루션입니다. 태국 은행의 결제 시스템 로드맵은 은행과 함께 태국의 결제 인프라를 현대화합니다. 은행 간 자금 이체를 위해 사용자는 휴대폰 번호, 주민등록번호, 법인 등록 번호 또는 디지털 지갑 번호와 같은 프록시를 통해 신원을 확인합니다.

특징 #

통화 처리THB
결제 통화USD
최소 거래 금액1 THB
최대 거래 금액5,000 THB
환불
부분 환불
여러 차례 부분 환불
차지백

결제 흐름 #

pic_2@2x.png

통합 방법 #

결제 방법 열거 값입니다: 프롬프트 페이

PromptPay에는 두 가지 통합 방법이 있습니다.

  1. 다이렉트 API
  2. 결제

직접 API #

통합하는 방법 #

직접 API 통합의 경우, 결제 인텐트를 생성하고 단 한 단계로 URL을 가져올 수 있습니다. 다음은 결제 인텐트 생성 데모입니다:

결제 인텐트 생성

결제 인텐트는 고객으로부터 결제를 수금하려는 의도를 나타내며 결제 프로세스의 라이프사이클을 추적하는 객체입니다. 서버에서 결제 인텐트를 생성하고 수금할 금액과 지원 통화를 지정합니다. 기존 결제 인텐트가 통합되어 있는 경우 결제 수단 유형 목록에 프롬프트페이를 추가합니다.

요청

{
    "amount":1000,
    "currency":"THB",
    "confirm":true,
    "payment_method_data" : {
        "유형":"프롬프트페이"
    },
    "return_url":"https://your.website"
}

응답

{
    "id": "pi_1664208234002513920",
    "객체": "payment_intent",
    "created": 1685613137000,
    "통화": "THB",
    "금액": 1000,
    "status": "requires_action",
    "livemode": false,
    "client_secret": "pi_1664208234002513920_secret_tzDL9JipXe0RE3qGTkNVty9j",
    "next_action": {
        "type": "promptpay_handle_redirect",
        "promptpay_handle_redirect": {
            "url": "https://apitest.wooshpay.com/v1/receives/c12/pay/pi_1664208234002513920"
        }
    },
    "payment_method_types": [
        "promptpay"
    ],
    "확인_방법": "automatic",
    "return_url": "https://your.website",
    "payment_method": "pm_1664208233880879104",
    "capture_method": "automatic"
}

결제 #

세션 만들기 #

요청

{
    "취소_URL": "www.wooshpay.com",
    "mode": "결제",
    "success_url": "https://wooshpay.com/",
    "payment_method_types": [
        "promptpay"
    ],
    "line_items": [
        {
            "price_data": {
                "currency": "THB",
                "단위_금액": 100,
                "닉네임": "apple",
                "product_data": {
                    "name": "apple"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "수량": 1
        }
    ]
}

응답

{
    "id": "cs_1676158633408200704",
    "객체": "checkout.session",
    "created": 1688462334000,
    "livemode": false,
    "통화": "THB",
    "customer": "",
    "모드": "결제",
    "상태": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1676158633408200704?key=pk_test_NTE2NzQzMzIzODEyNTI4MTY4OTYxOjEyVWdaRjhhSGpqOFZhRDZvaFRyc1RZbzE2ODgwMjY5MjU5NTk",
    "취소_URL": "www.wooshpay.com",
    "line_items": {
        "object": "목록",
        "데이터": [
            {
                "id": "li_1676158633437560832",
                "object": "item",
                "통화": "THB",
                "설명": "apple",
                "price": {
                    "id": "price_1676158633450143744",
                    "object": "가격",
                    "created": 1688462334000,
                    "livemode": false,
                    "active": true,
                    "통화": "THB",
                    "닉네임": "apple",
                    "product": {
                        "id": "prod_1676158633462726656",
                        "object": "제품",
                        "created": 1688462334000,
                        "livemode": false,
                        "active": true,
                        "name": "apple",
                        "updated": 1688462334000
                    },
                    "type": "one_time",
                    "단위_금액": 100,
                    "billing_scheme": "단위당",
                    "lookup_key": "test_lookup_key"
                },
                "수량": 1,
                "amount_subtotal": 100,
                "amount_total": 100
            }
        ]
    },
    "payment_intent": "pi_1676158633626304512",
    "payment_method_types": [
        "promptpay"
    ],
    "payment_status": "미지급",
    "success_url": "https://wooshpay.com/",
    "금액_소계": 100,
    "금액_총계": 100,
    "청구지_주소_수집": "auto",
    "expires_at": 1688548734385,
    "payment_link": "",
    "client_secret": "pi_1676158633626304512_secret_JbvbX6yCPEBB886Z46Rs5vw8"
}

다음 단계 #

필요에 따라 통합에 더 많은 기능을 추가할 수 있습니다.

웹훅 만들기 #

WooshPay 계정에서 이벤트를 수신하여 연동이 자동으로 반응을 트리거할 수 있도록 합니다. 활성화된 이벤트와 URL에 주로 초점을 맞춘 웹훅을 생성합니다.

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