이 페이지는 Cloud Translation API를 통해 번역되었습니다.

다양한 결제 유형 설정

다양한 구성을 지원하는 Actions Center 플랫폼 받을 수 있습니다. 이 결제 사용 설정 가이드에서는 통합과 관련하여 다음을 포함한 모든 결제 통합에 공통적으로 적용됩니다.

tokenization_parameter 정보를 포함하도록 피드 구성
payment_method_token을 수락하도록 예약 서버 업데이트 객체
사용자(작업 센터), 사용자 간 교환되는 정보에 대한 개요 파트너 / 판매자, 결제 대행업체

이 가이드에서는 피드를 구성하여 피드 유형의 결제 구성은 판매자 및 서비스에 적용됩니다.

결제 불가 / 도착 시 결제
전체 선불
예약 불이행 수수료 / 취소 수수료
입금

모든 결제 사용 사례는 결제 불가의 연장입니다. / 도착 시 지불 사용 사례 (결제 구성이 필요하지 않음)를 제공하므로 이 방법은 튜토리얼에서 해당 구성을 설명하고 구성을 확장 프로그램으로 사용할 수 있습니다

또한 각 섹션에서는 예약 서버에 있어야 합니다. 구성할 수 있습니다

결제 불가 / 도착 시 결제

예약 시 결제가 필요하지 않은 서비스의 경우 판매자 또는 서비스에 결제 구성이 필요하지 않음 있습니다. 하지만 가격은 계속 입력해야 합니다.

서비스의 기준 구성으로, 이름, 설명, 가격이 포함됩니다. 하나의 서비스 메시지입니다. 1초 이내 ServiceFeed:

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-1-a",
    "name": "Men's haircut",
    "description": "One of our stylists will cut your hair",
    "price": {
        "price_micros": 15000000,
        "currency_code": "USD"
    }
}

표준 구현 이외의 추가 구성이 필요하지 않습니다. 예약 서버에서 도착 시 지불을 지원합니다.

선불

이 구성은 예약 시 전액을 결제해야 합니다.

선불 결제는 prepayment_type 필드 Service 서비스 결제를 요구하려면 아래 예와 같이 REQUIRED로 설정해야 합니다. 참고: 도착 시 지불 예시와 같은 방식으로 가격이 지정되어 있습니다. 여기에서 선불 결제 유형을 필수로 설정하므로 신용카드가 결제 시점에 청구될 수 있습니다.

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Spa Treatment",
    "description": "A full spa treatment",
    "price": {
        "price_micros": "200000000",
        "currency_code": "USD"
    }
    "prepayment_type": "REQUIRED"
}

예약 서버

선불 결제를 수락하면 예약에 결제 토큰이 전달됩니다. 서버에 대한 필드를 통과하는 CreateBooking payment_processing_parameters.unparsed_payment_method_token '결제'를 통해 지정된 금액을 피드에 가격 필드가 있고 통화를 사용해야 합니다. 지정할 수 있습니다. 이러한 청구는 설명된 절차에 따라 진행해야 합니다. 를 결제 사용 설정 가이드를 참조하세요.

A/B 테스트를 CreateBookingResponse 드림 booking.payment_information 필드는 선불 결제가 처리되었음을 반영합니다.

이 PaymentInformation 사양에 전체 모든 결제 정보 옵션에 대한 설명서입니다. kubectl 명령어 선불 결제 처리에 대한 정보는 아래에 나와 있습니다. 가격을 설정할 때 가격 필드에 반환된 값이 합니다. 또한 피드/요청에 세율이 지정되어 있는 경우 도 정확하게 포함해야 합니다.

또한 거래 ID도 제공해야 합니다. 이 거래 ID 해당 판매자와의 거래에서 고유해야 합니다. 가 거래 ID는 맡길 수 있습니다.

JSON

{
    "prepayment_status": "PREPAYMENT_PROVIDED",
    "payment_processed_by": "PROCESSED_BY_PARTNER",
    "payment_transaction_id": "[this-transaction-id]",
    "price": {
        "price_micros": "200000000",
        "currency_code": "USD"
    }
}

예약 불이행 수수료

예약 불이행 수수료는 다음 날짜 이후에 취소하는 경우 취소 기간입니다. 취소 기간을 지정하지 않으면 슬롯의 시작 시간으로 설정됩니다

예약 불이행 수수료를 지정하려면 서비스 피드에 no_show_fee 필드를 사용해야 합니다.

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Spa Treatment",
    "description": "A full spa treatment",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    }
    "scheduling_rules": {
        "min_advance_online_canceling": 14400,
    }
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        }
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

위의 예에서 파트너 또는 판매자는 12월 30일부터 12월 31일까지 no_show_fee.fee.price_micros 필드(약속 보유자인 경우) 일정에 참석하지 않습니다. 사용자가 약속 전 4시간 (14,400초) 이내에 취소되며, scheduling_rules.min_advance_online_canceling에 지정됨 필드를 확인합니다.

이용 가능 여부 수준에서 프로그램 수수료를 정의하는 방법은 다음을 참조하세요. 이 섹션을 참조하세요.

예약 서버

예약 불이행 수수료가 포함된 요청을 처리할 때는 결제 토큰 다음 호출을 통해 예약 서버에 전달됩니다. 필드를 통과하는 CreateBooking payment_processing_parameters.unparsed_payment_method_token 이 토큰은 선불 결제에서와 동일한 방식으로 전달됩니다. 있습니다. 하지만 토큰은 짧은 기간 동안만 승인되기 때문에 결제 대행업체의 관련 API를 호출하여 이 토큰을 확인할 수 있습니다 이 내용은 결제 사용 설정 가이드 섹션에 설명되어 있습니다. 의 예약 불이행 수수료 토큰 흐름.

A/B 테스트를 CreateBookingResponse 드림 booking.payment_information 필드를 올바르게 설정해야 합니다. 아래의 예와 같이 예약 불이행 수수료의 상태를 다시 표시합니다.

JSON

{
    "prepayment_status": "PREPAYMENT_PROVIDED",
    "payment_processed_by": "PROCESSED_BY_PARTNER",
    "payment_transaction_id": "[this-transaction-id]",
    "price": {
        "price_micros": "200000000",
        "currency_code": "USD"
    }
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        }
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

no_show_fee는 가격을 반영하도록 설정되어 있으며 청구 가능한 수수료의 구조를 보여줍니다. 또한 선불 결제의 예를 들면 이 메시지에 transaction_id이(가) 필요합니다.

또한booking_id CreateBookingResponse 충전 시 전송해야 하는 실시간 업데이트에 대한 필수 입력란입니다. 예약 불이행 수수료 이 ID는 데이터 레이크의 정보와 함께 예약 정보

실시간 업데이트

사용자가 예약된 예약을 위해 도착하지 않거나 취소하는 경우 취소 기간이 지난 후 (예: 귀하에게 직접 연락) 원하는 경우 결제 정보를 사용하여 지정된 예약 불이행 수수료를 부과할 수 있습니다. 데이터를 저장합니다. 예약 불이행 수수료를 청구하는 경우 실시간 업데이트: 예약 불이행 수수료가 청구되었음을 명시합니다.

다음을 통해 생성된 예약 CreateBooking님, 업데이트를 전송할 대상 notification.partners.bookings.patch 이 요청의 본문에는 상태가 다음과 같이 설정된 업데이트된 예약 NO_SHOW_PENALIZED 이 상태를 통해 Google에 청구가 이뤄졌음을 알 수 있습니다. 있습니다.

예를 들어 요청은 다음으로 전송될 수 있습니다.

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/12345678/bookings/123123123?updateMask=status

요청 본문을 사용하는 경우:

JSON

{
    "name": "partners/12345678/bookings/123123123"
    "merchantId": "merchant-1"
    "serviceId": "service-2-b"
    "status": "NO_SHOW_PENALIZED"
}

입금

보증금은 예약. 보증금은 예약 시 또는 그 이후에 청구될 수 있습니다. 있습니다. 어떤 조건에 따라 보증금을 환불받을 수 있는지 정의해야 할 수도 있습니다. 또한 온라인으로 예약을 취소할 수 있는 경우

보증금을 지정하려면 서비스 피드에 deposit 필드를 사용해야 합니다.

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Spa Treatment",
    "description": "A full spa treatment",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    }
    "scheduling_rules": {
        "min_advance_online_canceling": 86400,
    }
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": USD,
            "min_advance_cancellation_sec": 14400,
        }
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

이 예에서 min_advance_online_canceling는 취소 기간과 deposit.min_advance_cancellation_sec 보증금이 환불 가능한 시기를 정의합니다. 위 예에서 입금은 취소 시간을 환불 약관과 분리합니다. 이 경우 사용자가 구독을 취소할 수 있습니다. 최대 24시간 전 (86,400초)에 온라인으로 서비스할 수 있습니다. 이렇게 하면 판매자가 취소 사실을 직접 통보합니다. 하지만 사용자는 여전히 4시간 전까지 보증금을 환불받을 수 있습니다. (14,400초 후) 예약 취소를 위해 본인 또는 판매자에게 문의하여 이는 결제 시 약관 및 확인 이메일에 표시됩니다.

이용 가능 여부 수준에서 보증금을 정의하는 방법은 다음을 참조하세요. 이 섹션을 참조하세요.

예약 서버

입금이 포함된 요청을 처리할 때 결제 토큰은 호출에서 예약 서버에 전달됩니다. 필드를 통과하는 CreateBooking payment_processing_parameters.unparsed_payment_method_token 이 토큰은 선불 결제 사례와 동일한 방식으로 전달됩니다. 만약 예약 시 보증금을 청구하거나 보류를 해제할 수 있습니다. 전송됩니다.

나중에 토큰을 충전하려는 경우에는 토큰이 짧은 기간 동안만 승인되는 경우에는 이 토큰을 만들 수도 있습니다. 이것은 Google 모바일 광고 SDK의 입금 토큰 흐름을 따릅니다.

A/B 테스트를 CreateBookingResponse booking.payment_information 필드는 필수 항목입니다. 아래와 같이 입금 상태를 적절히 다시 표시합니다.

JSON

{
    "prepayment_status": "PREPAYMENT_PROVIDED",
    "payment_processed_by": "PROCESSED_BY_PARTNER",
    "payment_transaction_id": "[this-transaction-id]",
    "price": {
        "price_micros": "200000000",
        "currency_code": "USD"
    }
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": USD,
            "min_advance_cancellation_sec": 28800,
        }
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

보증금은 보증금을 청구하거나 보류하는 것입니다. 또한 선불 결제의 예를 들면 이 메시지에 transaction_id이(가) 필요합니다.

실시간 업데이트

보증금 취소 기간 전에 사용자가 예약을 취소하는 경우 사용자 카드에 청구된 보증금을 모두 환불해야 합니다. 날짜 보증금을 환불하려는 경우 실시간 업데이트: 보증금이 환불되었음을 지정합니다.

다음을 통해 생성된 예약 CreateBooking님, 업데이트를 전송할 대상 notification.partners.bookings.patch 본문 요청은 상태가 다음과 같이 설정된 업데이트된 예약이어야 합니다. CANCELED 및 paymentInformation.prepaymentStatus 필드가 다음으로 설정됨 PREPAYMENT_REFUNDED입니다. 이를 통해 Google에 입금이 환불되었습니다.

예를 들어 요청은 다음으로 전송될 수 있습니다.

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/12345678/bookings/123123123?updateMask=status

요청 본문을 사용하는 경우:

JSON

{
    "name": "partners/12345678/bookings/123123123"
    "merchantId": "merchant-1"
    "serviceId": "service-2-b"
    "status": "CANCELED"
    "paymentInformation": {
      "prepaymentStatus": "PREPAYMENT_REFUNDED"
    }
    
}

신용카드 필요

서비스에서 추가 결제 수단으로 신용카드가 필요할 수 있습니다. 사용자 신원 확인 하지만 선불, 보증금, 예약 불이행 수수료가 있습니다. 이러한 사용 사례가 필요한 경우 다음 단계를 사용하여 명시적으로 구성해야 합니다. 참조하세요. 또한 신용카드를 요구하게 되면 이 서비스의 예약이 크게 감소했습니다.

결제 시 신용카드가 입력되도록 하려면 다음을 설정해야 합니다. require_credit_card 필드를 REQUIRE_CREDIT_CARD_ALWAYS입니다.

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-1-a",
    "name": "Men's haircut",
    "description": "One of our stylists will cut your hair",
    "price": {
        "price_micros": 15000000,
        "currency_code": "USD"
    },
    "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}

예약 서버

신용카드 요건이 포함된 요청을 처리할 때는 토큰이 예약 서버에 전달됩니다. 필드를 통과하는 CreateBooking payment_processing_parameters.unparsed_payment_method_token 이 토큰은 선불 결제에서와 동일한 방식으로 전달됩니다. 있습니다. 하지만 토큰은 짧은 기간 동안만 승인되기 때문에 결제 대행업체의 관련 API를 호출하여 이 토큰을 확인할 수 있습니다

예약 서버 응답에 추가 정보가 필요하지 않습니다. 도착 시 지불(pay-on-arrival) 사용 사례의 서비스를 뛰어넘는

가용성 수준에서 가격 책정 재정의

위의 모든 예에서는 가격 / 수수료 구조가 지정되어 있습니다. 서비스 수준에서 작동합니다 대부분의 경우 이 서비스 수준 가격은 있습니다. 하지만 경우에 따라 지급 구조를 변경하는 것이 좋습니다. 특정 이용 가능 시간대의 가격을 지정할 수 있습니다 예를 들어 가용성 수준에서 가격 / 수수료를 재정의하여 처리할 수 있습니다.

화요일에는 가격이 인하되고 토요일에는 인상됩니다.
오후 5시~오후 7시 사이 이용 가능 여부에 따라 예약 불이행 수수료가 적용됩니다.

아래 표에는 결제 / 수수료 수단별로 입력해야 하는 필드가 나와 있습니다. 사용하여 서비스 수준 정의를 재정의합니다.

지급 방식	수수료 / 가격 정의	재정의 여부
도착 시 결제	`Service.price`	가격 재정의 가능 기한: `Availability.payment_option_id` 참조 `Merchant.payment_option`
선불	`Service.price`	가격 재정의 가능 `Availability.payment_option_id` 참조 `Merchant.payment_option`
예약 불이행 수수료	`Service.no_show_fee`	`Availability.no_show_fee`
입금	`Service.deposit`	`Availability.deposit`
신용카드 필요	`Service.require_credit_card`	`Availability.require_credit_card`

재고 수준에서 가격을 재정의하려면 먼저 결제 옵션을 제공해야 합니다 또한 사용 가능한 수준의 취소 기간에 대해 자세히 알아보려면 가이드를 참조하세요. 취소 기간을 추가하는 방법