사전 빌드된 결제하기 구성요소를 사용하면 사용자를 인증 및 결제를 처리할 수 있습니다. 이 구성요소는 사전 빌드된 인증 구성요소 버전의 커스텀 버전을 사용하여 계정 소유자 및 카드 소지자를 인증합니다. 또한 이 구성요소는 사전 빌드된 이름 수집, 신용카드 만료일 수집,신용카드 CVV 수집 구성요소를 사용하여 결제에 필요한 정보를 수집합니다.
결제 유형
이 구성요소는 신용카드 청구서 및 수취인 계정의 결제를 지원합니다. 신용카드 청구서의 경우 사용자가 청구서의 최소 금액, 총 금액 또는 커스텀 금액을 지불할 수 있습니다. 사용자는 은행 계좌, 체크카드 또는 신용카드, 모바일 결제를 통해 결제할 수 있습니다.
| 결제 유형 | 사용 가능한 결제 수단 | 사용 가능한 결제 금액 |
|---|---|---|
| 신용카드 청구서 | 은행 계좌, 체크카드, 모바일 결제 | 최소, 총, 커스텀 금액 |
| 수취인 계정 | 은행 계좌, 신용카드, 체크카드, 모바일 결제 | 커스텀 금액 |
제한사항
사전 빌드 구성요소에는 일반적인 사전 빌드 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 이 구성요소는 데이터를 암호화하지 않습니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
수취인 계정 결제
에이전트는 사용자가 이전에 인증되지 않았음을 식별하고 사용자가 등록된 사용자인지 확인하기 위한 정보를 수집합니다. 사용자가 수취인 계정으로 결제하기를 원하는 것으로 나타나며, 에이전트는 수취인 이름을 포함하여 필요한 정보를 수집하고 계정 번호를 확인합니다. 마지막으로 사용자가 체크카드를 사용하여 결제하도록 선택하면 에이전트가 체크카드 번호, 만료일, CVV를 수집하고 결제를 확인합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다. | |
| 감사합니다. 인증이 성공적으로 완료되었습니다. | |
| 등록된 신용카드 청구서를 결제하거나 기존 수취인 계정으로 결제하시겠어요? | |
| 수취인 | |
| 에이전트가 사전 빌드된 이름 수집 구성요소를 사용하여 수취인 이름을 수집합니다. | |
| 감사합니다. 수취인 이름을 수집했습니다. 예, 저희 기록에 따르면 7821로 끝나는 계정 번호가 있습니다. 계정 번호를 확인하려면 예라고 답하세요. |
|
| 예 | |
| 결제할 금액을 확인해 주세요. 예를 들어 $100.30를 결제하려면 100 포인트 30으로 말합니다. | |
| 50달러 | |
| 은행 계좌, 체크카드, 신용카드 또는 모바일 결제로 결제하시겠어요? | |
| 체크카드 | |
| 말씀하시는 체크카드 번호의 마지막 네 자리 숫자를 알려주세요. | |
| 1234 | |
| 알려주신 체크카드의 마지막 4자리는 1234입니다. 맞나요? | |
| 예, 맞습니다. | |
| 에이전트가 사전 빌드된 신용카드 만료일 수집 구성요소를 사용하여 체크카드 만료일 수집 | |
| 좋습니다. 체크카드의 만료일 수집이 완료되었습니다. | |
| 에이전트가 사전 빌드된 신용카드 CVV 컬렉션 구성요소를 사용하여 체크카드 CVV 수집 | |
| 좋습니다. CVV 수집이 완료되었습니다. | |
| 예, 1234로 끝나는 체크카드로 Jane에게 50달러를 결제하겠습니다. 계속하길 원하시나요? | |
| 예 | |
| 계속 진행하기 위해 코드를 전송하겠습니다. 전화 또는 이메일 중 어디로 코드를 받으시겠습니까? | |
| 이메일로 보내주세요. | |
| 등록된 이메일 주소 john.doe@google.com으로 코드가 전송되었습니다. 몇 초 정도 걸릴 수 있습니다. 코드를 확인해 주시겠어요? | |
| 123456 | |
| 감사합니다. 결제를 완료하는 동안 몇 초 정도 기다려 주세요. 수취인 계정 결제가 완료되었습니다. |
신용카드 청구서 결제
에이전트는 사용자가 이전에 인증되지 않았음을 식별하고 사용자가 등록된 사용자인지 확인하기 위한 정보를 수집합니다. 사용자가 은행 계좌를 사용하여 신용카드 청구서를 결제하기를 원하는 것으로 나타납니다. 에이전트가 결제 금액과 결제 수단 세부정보를 확인하고 결제를 완료합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다. | |
| 감사합니다. 인증이 성공적으로 완료되었습니다. | |
| 등록된 신용카드 청구서를 결제하거나 기존 수취인 계정으로 결제하시겠어요? | |
| 신용카드 청구서 | |
| 말씀하시는 신용카드 번호의 마지막 4자리 숫자를 알려주세요. | |
| 4321 | |
| 신용카드 번호의 마지막 네 자리 숫자가 4321입니다. 맞나요? | |
| 예 | |
| 총 청구 금액은 300달러이고 최소 결제 금액은 20달러입니다. 총 금액, 최소 금액 또는 다른 금액을 결제하고 싶으신가요? | |
| 총 금액 | |
| 은행 계좌, 체크카드 또는 모바일 결제로 결제하시겠어요? | |
| 저축 계좌 | |
| 귀하의 전화번호와 연결된 계정이 2개 있습니다. 말씀하시는 계정의 마지막 네 자리 숫자를 알려주세요. | |
| 1001 | |
| 계정 번호의 마지막 네 자리 숫자는 1001입니다. 맞나요? | |
| 예 | |
| 예, 1001로 끝나는 계정을 사용하여 4321로 끝나는 신용카드 청구서의 300달러를 결제하겠습니다. 계속하길 원하시나요? | |
| 예 | |
| 계속 진행하기 위해 코드를 전송하겠습니다. 전화 또는 이메일 중 어디로 코드를 받으시겠습니까? | |
| 이메일로 전송 | |
| 등록된 이메일 주소 john.doe@google.com으로 코드가 전송되었습니다. 몇 초 정도 걸릴 수 있습니다. 코드를 확인해 주시겠어요? | |
| 123456 | |
| 좋습니다. 결제하는 동안 몇 초 정도 기다려 주세요. 신용카드 결제가 완료되었습니다. |
자금 또는 한도 부족
에이전트는 사용자가 이전에 인증되지 않았음을 식별하고 사용자가 등록된 사용자인지 확인하기 위한 정보를 수집합니다. 사용자가 은행 계좌와 체크카드를 사용하여 신용카드 청구서를 결제하려고 하지만, 금액이 부족하거나 한도가 초과되어 두 결제 모두 거부됩니다. 마지막으로 사용자가 모바일 결제를 선택하면 에이전트가 모바일 결제를 완료할 수 있는 링크를 보냅니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다. | |
| 감사합니다. 인증이 성공적으로 완료되었습니다. | |
| 등록된 신용카드 청구서를 결제하거나 기존 수취인 계정으로 결제하시겠어요? | |
| 신용카드 | |
| 말씀하시는 신용카드 번호의 마지막 4자리 숫자를 알려주세요. | |
| 4321 | |
| 신용카드 번호의 마지막 네 자리 숫자가 4321입니다. 맞나요? | |
| 예 | |
| 총 청구 금액은 300달러이고 최소 결제 금액은 20달러입니다. 총 금액, 최소 금액 또는 다른 금액을 결제하고 싶으신가요? | |
| 총 금액 | |
| 은행 계좌, 체크카드 또는 모바일 결제로 결제하시겠어요? | |
| 예금 | |
| 귀하의 전화번호와 연결된 계정이 2개 있습니다. 말씀하시는 계정의 마지막 네 자리 숫자를 알려주세요. | |
| 1002 | |
| 계정 번호의 마지막 네 자리 숫자는 1002입니다. 맞나요? | |
| 예 | |
| 예, 1002로 끝나는 계정을 사용하여 4321로 끝나는 신용카드 청구서의 300달러를 결제하겠습니다. 계속하길 원하시나요? | |
| 예 | |
| 계속 진행하기 위해 코드를 전송하겠습니다. 전화 또는 이메일 중 어디로 코드를 받으시겠습니까? | |
| 이메일 | |
| 등록된 이메일 주소 john.doe@google.com으로 코드가 전송되었습니다. 몇 초 정도 걸릴 수 있습니다. 코드를 확인해 주시겠어요? | |
| 123456 | |
| 좋습니다. 결제를 완료하는 동안 몇 초 정도 기다려 주세요. 계정의 자금이 부족하여 결제가 실패했습니다. 다른 결제 수단으로 결제를 다시 시도하시겠어요? |
|
| 예 | |
| 은행 계좌, 체크카드 또는 모바일 결제로 결제하시겠어요? | |
| 체크카드 | |
| 말씀하시는 체크카드 번호의 마지막 네 자리 숫자를 알려주세요. | |
| 2345 | |
| 알려주신 체크카드의 마지막 4자리는 1234입니다. 맞나요? | |
| 예 | |
| 에이전트가 사전 빌드된 신용카드 만료일 수집 구성요소를 사용하여 체크카드 만료일 수집 | |
| 좋습니다. 체크카드의 만료일 수집이 완료되었습니다. | |
| 에이전트가 사전 빌드된 신용카드 CVV 컬렉션 구성요소를 사용하여 체크카드 CVV 수집 | |
| 좋습니다. CVV 수집이 완료되었습니다. | |
| 예, 2345로 끝나는 체크카드 번호를 사용하여 4321로 끝나는 신용카드 청구서의 300달러를 결제하겠습니다. 계속하길 원하시나요? | |
| 예 | |
| 계속 진행하기 위해 코드를 전송하겠습니다. 전화 또는 이메일 중 어디로 코드를 받으시겠습니까? | |
| 이메일 | |
| 등록된 이메일 주소 john.doe@google.com으로 코드가 전송되었습니다. 몇 초 정도 걸릴 수 있습니다. 코드를 확인해 주시겠어요? | |
| 123456 | |
| 좋습니다. 결제하는 동안 몇 초 정도 기다려 주세요. 체크카드의 한도가 초과되어 결제에 실패했습니다. 다른 결제 수단으로 결제를 다시 시도하시겠어요? |
|
| 예 | |
| 은행 계좌, 체크카드 또는 모바일 결제로 결제하시겠어요? | |
| 모바일 | |
| 알겠습니다. 등록된 휴대전화 번호로 결제 링크를 전송하고 있습니다. 이 작업은 몇 초 정도 걸릴 수 있습니다. 링크를 받으셨다면 '예'라고 답하여 확인해 주세요. | |
| 예 | |
| 좋습니다. 이제 링크를 열어 결제를 계속 진행할 수 있습니다. |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 결제하기 |
| 구성요소별 인텐트 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_make_a_payment_payment_type |
| 항목 유형 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_make_a_payment_payment_mode |
| 웹훅 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_make_a_payment:process_payment_credit_card |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.auth_level | (선택사항) 호출자의 인증 레벨을 나타냅니다. | 정수 |
| $session.params.auth_level_req | 사용자가 자신의 거래 기록에 액세스하기 전에 필요한 인증 레벨을 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 1입니다. |
정수 |
| $session.params.account_auth_enabled | 인증 유형에 설명된 대로 사용자를 계좌 소유자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 true입니다. |
부울 |
| $session.params.card_auth_enabled | 인증 유형에 설명된 대로 사용자를 카드 소지자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 false입니다. |
부울 |
| $session.params.phone_number | (선택사항) 인증에 사용된 고객의 등록된 전화번호입니다. | 문자열 |
| $flow.payment_success_code | 결제가 성공했음을 나타내는 process_payment 웹훅으로 반환된 payment_status_code 필드 값을 지정합니다. 기본적으로 이 값은 "200"입니다. |
문자열 |
| $flow.insufficient_fund_code | 자금 부족으로 인해 결제를 완료할 수 없음을 나타내는 process_payment 웹훅으로 반환된 payment_status_code 필드 값을 지정합니다. 기본적으로 이 값은 "400"입니다. |
문자열 |
| $flow.limit_exceed_code | 일일 한도를 초과하여 결제를 완료할 수 없음을 나타내는 process_payment 웹훅으로 반환된 payment_status_code 필드 값을 지정합니다. 기본적으로 이 값은 "401"입니다. |
문자열 |
| $flow.max_retry_mop_counter | 사용자가 결제 수단을 변경할 수 있는 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.max_retry_credit_card_payment | 결제 수단으로 지정된 신용카드를 사용하여 결제하려고 시도할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
| $flow.max_retry_mobile_payment_counter | 결제 수단으로 지정된 모바일 결제를 사용하여 결제하려고 시도할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.max_retry_creditcard_count | 결제를 위해 유효한 신용카드 번호를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
| $flow.max_retry_acc_number | 결제를 위해 유효한 계정 세부정보를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
| $flow.max_retry_debit_card_details | 결제를 위해 유효한 체크카드 세부정보를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
| $flow.max_retry_credit_card_details | 결제를 위해 유효한 신용카드 세부정보를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
| $flow.otp_length | 사용자에게 전송되는 일회용 비밀번호의 예상 길이를 지정합니다. 기본값은 6입니다. |
정수 |
| $flow.max_retry_otp_count | 사용자로부터 유효한 일회용 비밀번호(OTP)를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
| $flow.max_waiting_room_counter | 사용자가 모바일 결제 링크를 받을 때 에이전트에게 대기를 요청할 수 있는 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| auth_level | 호출자의 인증 레벨을 나타냅니다. | 정수 |
| phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| transfer_reason | 이 매개변수는 성공하지 않은 경우 흐름이 종료된 이유를 나타냅니다. 반환된 값은 다음 중 하나입니다.agent: 최종 사용자가 대화 중 특정 시점에서 에이전트를 요청했습니다.denial_of_information: 최종 사용자가 구성 요소에서 요청한 정보 공유를 거부했습니다.max_no_input: 대화가 입력되지 않은 이벤트에 대한 최대 재시도 횟수에 도달했습니다. no-input 기본 제공 이벤트를 참조하세요.max_no_match: 대화가 일치하지 않는 이벤트의 최대 재시도 횟수에 도달했습니다. no-match 기본 제공 이벤트를 참조하세요.webhook_error: 웹훅 오류가 발생했습니다. webhook.error 기본 제공 이벤트를 참조하세요. webhook_not_found: 웹훅 URL에 연결할 수 없습니다. webhook.error.not-found 기본 제공 이벤트를 참조하세요. |
문자열 |
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 구성요소를 가져옵니다.
- 외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 아래 웹훅 설정을 참조하세요.
웹훅 설정
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
인증
인증에 필요한 외부 서비스를 이전에 구성하지 않았으면 이 구성요소에 대해 사용자 인증을 사용 설정하기 위해 이를 구성해야 합니다. 자세한 내용은 인증 웹훅 설정을 참조하세요.
계정 검증
prebuilt_components_account_services:validate_account 웹훅은 구성요소에서 사용자의 등록된 전화번호 및 제공된 계좌 번호의 마지막 4자리를 기준으로 계좌가 존재하는지 확인하는 데 사용됩니다.
계좌가 존재하는 경우 웹훅에서 계좌 잔액도 반환합니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.last_four_digit_of_account_number | 사용자가 결제를 위해 선택하고 확인한 계좌 번호의 마지막 4자리 숫자입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| account_found | 사용자의 등록된 계좌에 제공된 마지막 4자리 숫자가 포함된 계좌가 있는지 여부를 나타냅니다. | 부울 |
| 잔액 | 계좌의 현재 잔액(존재하는 경우)입니다. | 숫자 |
이 구성요소에 계좌 검증 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_account_services:validate_account 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
사용자 카드 세부정보
prebuilt_components_make_a_payment:user_card_details 웹훅은 구성요소에서 등록된 사용자의 체크카드 및 신용카드 세부정보를 가져오는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| credit_card_count | 등록된 전화번호와 연결된 신용카드 개수입니다. | 정수 |
| last_four_digit_of_credit_card_number | 사용자 신용카드의 마지막 4자리 숫자입니다. 고객이 신용카드를 여러 개 가지고 있으면 이 값은 null입니다. |
문자열 |
| debit_card_count | 등록된 전화번호와 연결된 체크카드의 개수입니다. | 정수 |
| last_four_digit_of_debit_card_number | 사용자 체크카드의 마지막 4자리 숫자입니다. 고객에게 체크카드가 여러 개 있는 경우 이 값은 null입니다. |
문자열 |
이 구성요소에 사용자 카드 세부정보 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:user_card_details 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
수취인 이름 확인
prebuilt_components_make_a_payment:verify_beneficiary_name 웹훅은 구성요소에서 사용자가 제공한 이름에 수취인 계정가 있는지 확인하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.name_collection_first_name | 수취인의 이름입니다. | 문자열 |
| $session.params.name_collection_last_name | 수취인의 성입니다. | 문자열 |
| $session.params.name_collection_middle_name | 수취인의 중간 이름입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| beneficiary_account_number | 제공된 수취인 이름의 수취인 계정 번호 마지막 4자리 숫자입니다. 제공된 이름의 수취인 계정을 찾을 수 없는 경우 값은 null입니다. |
문자열 |
이 구성요소에 수취인 이름 확인 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:verify_beneficiary_name 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
미결제 금액 가져오기
prebuilt_components_make_a_payment:get_due_amount 웹훅은 구성요소에서 사용자의 신용카드 청구서에 대해 결제해야 하는 최소 및 총 금액에 대한 정보를 가져오는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.user_credit_card_number | 사용자 신용카드의 마지막 4자리 숫자입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| minimum_amount | 지정된 신용카드 청구서에 대해 결제해야 하는 최소 금액입니다. | 숫자 |
| total_amount | 지정된 신용카드 청구서에 대해 결제해야 하는 총 금액입니다. | 숫자 |
이 구성요소에 청구 금액 가져오기 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:get_due_amount 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
신용카드 번호 확인
prebuilt_components_make_a_payment:verify_credit_card_number 웹훅은 구성요소에서 제공된 신용카드 번호가 사용자 계정에 등록되어 있는지 확인하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.user_credit_card_number | 사용자 신용카드의 마지막 4자리 숫자입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| card_found | 제공된 신용카드가 검색되는지 여부를 나타냅니다. | 부울 |
이 구성요소에 신용카드 번호 확인 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:verify_credit_card_number 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
신용카드 세부정보 확인
prebuilt_components_make_a_payment:verify_credit_card_details 웹훅은 구성요소에서 만료일 및 CVV를 포함하여 제공된 세부정보가 사용자가 제공한 신용카드에 유효한지 확인하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.credit_card_number | 사용자 신용카드의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.credit_card_exp_date | 사용자가 해당 신용카드에 대해 제공한 신용카드의 만료일입니다. | { |
| $flow.credit_card_cvv_code | 사용자가 해당 신용카드에 대해 제공한 CVV 코드입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| creditcard_verification_status | 제공된 신용카드 세부정보가 검증되었는지 여부를 나타냅니다. | 부울 |
이 구성요소에 신용카드 세부정보 확인 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:verify_credit_card_details 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
체크카드 세부정보 확인
prebuilt_components_make_a_payment:verify_debit_card_details 웹훅은 구성요소에서 만료일 및 CVV를 포함하여 제공된 세부정보가 사용자가 제공한 체크카드에 유효한지 확인하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.debit_card_number | 사용자 체크카드의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.debit_card_exp_date | 사용자가 해당 체크카드에 대해 제공한 체크카드 만료일입니다. | { |
| $flow.debit_card_cvv_code | 사용자가 해당 체크카드에 대해 제공한 CVV 코드입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| debitcard_verification_status | 제공된 체크카드 세부정보가 검증되었는지 여부를 나타냅니다. | 부울 |
이 구성요소에 체크카드 세부정보 확인 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:verify_debit_card_details 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
신용카드 결제 프로세스
prebuilt_components_make_a_payment:process_payment_credit_card 웹훅은 구성요소에서 제공된 신용카드 세부정보를 사용하여 결제를 처리하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.payee_number | 지급을 받을 수취인 계정 번호의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.payment_type | 결제의 결제 유형입니다. 유효한 값은 prebuilt_components_make_a_payment_payment_type 커스텀 항목으로 정의됩니다. 기본적으로 이 구성요소는 "beneficiary_pay" 및 "credit_card_pay"를 지원합니다. |
문자열 |
| $flow.credit_card_number | 사용자 신용카드의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.credit_card_exp_date | 사용자가 해당 신용카드에 대해 제공한 신용카드의 만료일입니다. | { |
| $flow.credit_card_cvv_code | 사용자가 해당 신용카드에 대해 제공한 CVV 코드입니다. | 문자열 |
| $flow.payment_amount | 사용자가 결제하기로 선택한 금액입니다. | 숫자 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| payment_status_code | 결제가 완료되었는지 여부를 나타냅니다. 유효한 값은 $flow.payment_success_code, $flow.insufficient_fund_code, $flow.limit_exceed_code의 구성 가능한 입력 매개변수로 정의됩니다. |
문자열 |
이 구성요소에 신용카드 결제 프로세스 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:process_payment_credit_card 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
체크카드 결제 프로세스
prebuilt_components_make_a_payment:process_payment_debit_card 웹훅은 구성요소에서 제공된 체크카드 세부정보를 사용하여 결제를 처리하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.payee_number | 지급을 받을 수취인 계정 번호의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.payment_type | 결제의 결제 유형입니다. 유효한 값은 prebuilt_components_make_a_payment_payment_type 커스텀 항목으로 정의됩니다. 기본적으로 이 구성요소는 "beneficiary_pay" 및 "credit_card_pay"를 지원합니다. |
문자열 |
| $flow.debit_card_number | 사용자 체크카드의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.debit_card_exp_date | 사용자가 해당 체크카드에 대해 제공한 체크카드 만료일입니다. | { |
| $flow.debit_card_cvv_code | 사용자가 해당 체크카드에 대해 제공한 CVV 코드입니다. | 문자열 |
| $flow.payment_amount | 사용자가 결제하기로 선택한 금액입니다. | 숫자 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| payment_status_code | 결제가 완료되었는지 여부를 나타냅니다. 유효한 값은 $flow.payment_success_code, $flow.insufficient_fund_code, $flow.limit_exceed_code의 구성 가능한 입력 매개변수로 정의됩니다. |
문자열 |
이 구성요소에 체크카드 결제 프로세스 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:process_payment_debit_card 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
계정 결제 프로세스
prebuilt_components_make_a_payment:process_payment_account 웹훅은 구성요소에서 제공된 계정 세부정보를 사용하여 결제를 처리하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.payee_number | 지급을 받을 수취인 계정 번호의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.payment_type | 결제의 결제 유형입니다. 유효한 값은 prebuilt_components_make_a_payment_payment_type 커스텀 항목으로 정의됩니다. 기본적으로 이 구성요소는 "beneficiary_pay" 및 "credit_card_pay"를 지원합니다. |
문자열 |
| $session.params.last_four_digit_of_account_number | 사용자 계정의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.payment_amount | 사용자가 결제하기로 선택한 금액입니다. | 숫자 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| payment_status_code | 결제가 완료되었는지 여부를 나타냅니다. 유효한 값은 $flow.payment_success_code, $flow.insufficient_fund_code, $flow.limit_exceed_code의 구성 가능한 입력 매개변수로 정의됩니다. |
문자열 |
이 구성요소에 계정 결제 프로세스 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:process_payment_account 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
모바일 결제 프로세스
prebuilt_components_make_a_payment:process_payment_mobile 웹훅은 구성요소에서 사용자가 선택한 결제 세부정보의 모바일 결제 링크를 생성하고 전송하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.payee_number | 지급을 받을 수취인 계정 번호의 마지막 4자리 숫자입니다. | 문자열 |
| $flow.payment_type | 결제의 결제 유형입니다. 유효한 값은 prebuilt_components_make_a_payment_payment_type 커스텀 항목으로 정의됩니다. 기본적으로 이 구성요소는 "beneficiary_pay" 및 "credit_card_pay"를 지원합니다. |
문자열 |
| $flow.payment_amount | 사용자가 결제하기로 선택한 금액입니다. | 숫자 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| payment_link_generated | 모바일 결제 링크가 생성되어 사용자에게 전송되었는지 여부를 나타냅니다. | 부울 |
이 구성요소에 모바일 결제 프로세스 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_make_a_payment:process_payment_mobile 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
완료
이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.