2023년 6월 13일에 대화형 작업이 종료되기 전에 2023년 5월 3일에 Transactions API가 지원 중단됩니다. 자세한 내용은
대화 작업 지원 중단을 참고하세요.
실제 트랜잭션 문제 해결 (Dialogflow)
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
작업으로 거래 인텐트를 처리하는 데 문제가 있는 경우
다음 섹션에 설명된 증상 중 하나가 발생하는 경우
권장되는 문제 해결 단계를 따릅니다.
작업이 응답하지 않음
증상: 트랜잭션 인텐트 (TransactionRequirements, TransactionDecision)를 트리거할 때 사용자는 '현재 앱이 응답하지 않습니다. 잠시 후 다시 시도해 주세요.'
문제 해결: 작업 프로젝트에 개인정보처리방침 링크를 포함하여 필수 디렉터리 정보가 모두 있는지 확인합니다.
영수증을 처리할 수 없음
증상: 구매 승인 중에 사용자는 다음과 같은 응답을 받습니다.
'죄송합니다. 영수증을 처리할 수 없습니다.'
문제 해결:
merchantOrderId이 고유해야 합니다. 새로 주문할 수 없습니다.
이전 주문 ID로 대체합니다.- 간단한 응답을 전송해야 합니다.
첫 번째
orderUpdate과 함께 필수 응답 형식입니다.
주문 업데이트를 보낼 수 없음
증상: 기존 주문의 주문 업데이트를 전송하면 Orders API에서
오류 코드 500과 함께 다음 오류 메시지로 응답합니다. "OrderID 주문
ProjectID 프로젝트의 을(를) 업데이트할 수 없습니다. 다시 시도해 주세요.' 오류 메시지가 표시되는 경우
문제 해결:
주문 업데이트가 알림에 표시되지 않음
증상: 최초 주문이 완료되고 후속 주문 업데이트가
상태 코드 200이지만 사용자의 어시스턴트 지원에 푸시 알림으로 표시되지 않음
있습니다.
문제 해결: 모든 주문 업데이트가 푸시 알림으로 반영되지는 않습니다.
CANCELLED, FULFILLED, REJECTED 또는 RETURNED 상태의 업데이트만
알림을 표시합니다.
계정에서 거래 보기
다음 단계에 따라 계정을 통해 거래한 내역을 확인할 수 있습니다.
- myaccount.google.com으로 이동하여 로그인합니다.
- 지급 및 구독을 클릭합니다.
- 구매 내역에서 구매 내역 관리를 클릭합니다.
다음 URL 쿼리 매개변수를 추가하여 샌드박스 거래를 볼 수도 있습니다.
myaccount.google.com/purchases?sandbox=1
기타 문제 해결 도움말
위의 증상들이 겪고 있는 문제에 해당되지 않는다면 다음과 같은 조치를 취할 수 있습니다.
프로젝트의 Stackdriver 로그를 참고하려는 경우
추가 문제 해결 단계를 따르세요. Google 계정 설정을 참조할 수도 있습니다.
를 사용하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis troubleshooting guide helps you resolve issues when users can't complete transactions with your Action.\u003c/p\u003e\n"],["\u003cp\u003eCommon problems include the Action not responding, issues processing receipts, difficulties sending or receiving order updates, and viewing transaction history.\u003c/p\u003e\n"],["\u003cp\u003eSolutions involve verifying Action settings, ensuring unique order IDs, using correct response formats, and checking authentication credentials.\u003c/p\u003e\n"],["\u003cp\u003eOrder update notifications are only sent for specific status changes like cancellations, fulfillments, rejections, or returns.\u003c/p\u003e\n"],["\u003cp\u003eFor further assistance, consult Stackdriver logs or review your Google Account settings for purchase history and management.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting Physical Transactions (Dialogflow)\n\nIf you're having trouble fulfilling transaction intents with your Action, see if\nyou're experiencing any of the symptoms described in the following sections and\ntake the recommended troubleshooting steps.\n\nAction not responding\n---------------------\n\n**Symptom:** When triggering a transactions intent (`TransactionRequirements`, `TransactionDecision`), the user gets back a response of *\"App isn't responding at the moment. Try again soon.\"*\n\n**Troubleshooting:** Ensure your Action project has all the required directory information, including a privacy policy link.\n\nUnable to process receipt\n-------------------------\n\n**Symptom:** During purchase authorization, the user gets a response saying\n\"*Sorry, I am unable to process your receipt.*\"\n\n**Troubleshooting:**\n\n- Make sure your `merchantOrderId` is unique. A new order can't be placed with a previous, existing order ID.\n- Make sure you're sending a [simple response](/assistant/conversational/responses#simple_responses) alongside the initial `orderUpdate`; this is the mandatory response format.\n\nUnable to send order updates\n----------------------------\n\n**Symptom:** When sending an order update for an existing order, the Orders API\nresponds with error code 500 and the following error message: \"*Order `OrderID`\nfor project `ProjectID` could not be updated. Please try again.*\"\n\n**Troubleshooting:**\n\n- Make sure you're supplying working credentials during [JWT authentication for\n the Orders API](https://github.com/google/google-api-nodejs-client#using-jwt-service-tokens).\n\nOrder updates not appearing as notifications\n--------------------------------------------\n\n**Symptom:** Initial order is placed and follow-up order updates succeed with\nstatus code 200 but don't appear as push notifications on the user's Assistant-enabled\ndevice.\n\n**Troubleshooting:** Not all order updates will be reflected as a push notification;\nonly updates with a status of `CANCELLED`, `FULFILLED`, `REJECTED`, or `RETURNED`\nresult in a notification.\n\nView transactions on your account\n---------------------------------\n\nYou can view transactions that have been made through your account by following these steps:\n\n1. Navigate to [myaccount.google.com](/assistant/df-asdk/transactions/physical/myaccount.google.com) and log in.\n2. Click **Payments \\& subscriptions** in the left menu.\n3. Under **Purchases** , click **Manage purchases**.\n\nYou can also view sandbox transactions by adding the following URL query parameter: \n\n```text\nmyaccount.google.com/purchases?sandbox=1\n```\n\nOther troubleshooting tips\n--------------------------\n\nIf the above symptoms don't describe the problem you're running into, you may\nwant to refer to your project's [Stackdriver logs](/assistant/console/troubleshooting)\nfor further troubleshooting. You can also refer to your [Google Account settings](https://myaccount.google.com/preferences?pli=1#subscriptions)\nto view and manage any purchases you've made with your Action."]]
