Google Pay 결제 수단

이 참조는 카드 결제 수단 스키마 를 기반으로 하며, Google Pay 결제 핸들러가 결제 완료 시 payment.instruments 배열 내에서 반환하는 결제 수단 객체에 대한 것입니다.

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

속성

속성 유형 항상 표시 여부 설명
id 문자열 예 플랫폼에서 할당한 이 결제 수단 인스턴스의 고유 식별자입니다.
handler_id 문자열 예 이 수단을 생성한 핸들러 인스턴스의 고유 식별자입니다. 결제 핸들러 구성의 id 필드에 해당합니다.
type 문자열 예 결제 수단의 유형입니다(예: card).
selected 부울 아니요 사용자가 이 수단을 선택했는지 나타냅니다.
display 객체 예 결제 수단의 표시 정보입니다.
display.brand 문자열 예 카드 브랜드/네트워크입니다 (예: 'VISA').
display.last_digits 문자열 예 카드 번호의 마지막 4자리 숫자입니다.
display.description 문자열 아니요 사용자에게 표시되는 카드 설명입니다.
display.card_art 문자열 아니요 카드를 나타내는 이미지의 URI입니다.
billing_address 객체 아니요 카드와 연결된 청구서 수신 주소입니다. 구성에서 billing_address_required가 true로 설정된 경우에만 반환됩니다.
billing_address.first_name 문자열 아니요 주소와 연결된 연락처의 이름입니다.
billing_address.last_name 문자열 아니요 주소와 연결된 연락처의 성입니다.
billing_address.street_address 문자열 아니요 상세 주소입니다.
billing_address.extended_address 문자열 아니요 주소 확장 프로그램입니다 (예: 아파트 동/호수).
billing_address.address_locality 문자열 아니요 지역입니다 (예: 도시).
billing_address.address_region 문자열 아니요 지역입니다 (예: 주, 도).
billing_address.postal_code 문자열 아니요 우편번호입니다.
billing_address.address_country 문자열 아니요 국가 코드입니다 (2자리 ISO 3166-1 alpha-2 형식).
billing_address.phone_number 문자열 아니요 전화번호입니다. 구성에서 phone_number_required가 true로 설정된 경우에만 반환됩니다.
credential 객체 아니요 Google Pay에서 반환하는 보안 토큰화 데이터입니다.
credential.type 문자열 예 토큰화 유형입니다. 구성된 유형과 일치합니다.
credential.token 문자열 예 JSON 직렬화된 문자열로 된 암호화된 결제 사용자 인증 정보 토큰입니다.

PAYMENT_GATEWAY의 경우 게이트웨이에 전달할 암호화된 페이로드가 포함됩니다. DIRECT의 경우 암호화된 카드 세부정보가 포함됩니다 (비공개 키를 사용하여 복호화해야 함). 형식 및 복호화 프로세스에 관한 자세한 내용은 결제 데이터 암호화 가이드를 참고하세요.