Method: getDisputeInquiryReport

একটি প্রতিবেদন পান যা একটি অর্থ প্রদানের সম্ভাব্য বিরোধের বিষয়ে ব্যবহারকারীর সাথে গ্রাহক সহায়তা কথোপকথনের সুবিধার্থে তথ্য সরবরাহ করে।

এই পদ্ধতিটি HTTP 200 ফেরত না দিলে এই প্রশ্নের উত্তরগুলি খালি হতে পারে৷

অনুরোধটি প্রক্রিয়া করার সময় যদি এন্ডপয়েন্ট কোনো ত্রুটির সম্মুখীন হয়, তাহলে এই এন্ডপয়েন্ট থেকে পাওয়া প্রতিক্রিয়া হবে ErrorResponse টাইপ।

যদি এই পদ্ধতিটি HTTP 200 ফেরত না দেয় তবে এই প্রশ্নের উত্তরগুলি খালি হতে পারে৷ প্রতিক্রিয়ার অংশটি এমন পরিস্থিতিতে খালি থাকে যেখানে একটি স্পষ্ট বিবরণ সহ একটি ErrorResponse আক্রমণকারীকে অন্যান্য ইন্টিগ্রেটরের পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট শনাক্তকারী বুঝতে সাহায্য করতে ব্যবহার করা যেতে পারে৷ এই পরিস্থিতিতে, যেখানে হয় সাইনিং কী মেলে না, পেমেন্ট ইন্টিগ্রেটর শনাক্তকারী পাওয়া যায়নি, বা এনক্রিপশন কী অজানা ছিল, এই পদ্ধতিটি একটি খালি বডি সহ HTTP 404 ফিরিয়ে দেবে। যদি অনুরোধ স্বাক্ষর যাচাই করা যায়, ত্রুটি সংক্রান্ত অতিরিক্ত তথ্য প্রতিক্রিয়া বডিতে ফেরত দেওয়া হবে।

একটি উদাহরণ অনুরোধ এর মত দেখায়:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 3
    },
    "requestId": "HsKv5pvtQKTtz7rdcw1YqE",
    "requestTimestamp": {
      "epochMillis": "1519996751331"
    },
    "paymentIntegratorAccountId": "InvisiCashUSA_USD"
  },
  "paymentLookupCriteria": {
    "googleTransactionReferenceNumberCriteria": {
      "googleTransactionReferenceNumber": "714545417102363157911822",
      "authorizationCode": "111111"
    }
  },
  "existingGoogleClaimId": "138431383281",
  "requestOriginator": {
    "organizationId": "ISSUER_256",
    "organizationDescription": "Community Bank of Some City",
    "agentId": "982749"
  }
}

একটি উদাহরণ প্রতিক্রিয়া মত দেখায়:


{
  "responseHeader": {
    "responseTimestamp": {
      "epochMillis": "1519996752221"
    }
  },
  "result": {
    "success": {
      "googleClaimId": "138431383281",
      "report": {
        "customerAccount": {
          "customerEmail": "example@gmail.com",
          "customerName" : "Example Customer"
        },
        "order": {
          "timestamp": {
            "epochMillis": "1517992525972"
          },
          "orderId": "SOP.8976-1234-1234-123456..99",
          "subTotalAmount": {
            "amountMicros": "206990000",
            "currencyCode": "USD"
          },
          "totalAmount": {
            "amountMicros": "212990000",
            "currencyCode": "USD"
          },
          "shippingAddress": {
            "addressLine": ["123 Main St"],
            "localityName": "Springfield",
            "administrativeAreaName": "CO",
            "postalCodeNumber": "80309",
            "countryCode": "US"
          },
          "taxes": [
            {
              "description": "Colorado Sales Tax",
              "amount": {
                "amountMicros": "6000000",
                "currencyCode": "USD"
              }
            }
          ],
          "items": [
            {
              "description": "Super cool gizmo",
              "merchant": "HTC",
              "googleProductName": "Google Store",
              "quantity": "2",
              "totalPrice": {
                "amountMicros": "198000000",
                "currencyCode": "USD"
              }
            },
            {
              "description": "Gizmo charger",
              "merchant": "HTC",
              "googleProductName": "Google Store",
              "quantity": "1",
              "totalPrice": {
                "amountMicros": "8990000",
                "currencyCode": "USD"
              }
            }
          ]
        },
        "payment": {
          "billingAddress" : {
            "addressLine": ["123 Main St"],
            "localityName": "Springfield",
            "administrativeAreaName": "CO",
            "postalCodeNumber": "80309",
            "countryCode": "US"
          },
          "amount": {
            "amountMicros": "100000000",
            "currencyCode": "USD"
          },
          "refunds": [
            {
              "amount": {
                "amountMicros": "9250000",
                "currencyCode": "USD"
              },
              "initiatedTimestamp": {
                "epochMillis": "1518811245384"
              }
            }
          ],
          "cardDetails": {
            "authResult": "APPROVED"
          }
        }
      }
    }
  }
}

HTTP অনুরোধ

POST https://vgw.googleapis.com/secure-serving/gsp/v3/getDisputeInquiryReport/ :PIAID

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentLookupCriteria": {
    object (PaymentLookupCriteria)
  },
  "existingGoogleClaimId": string,
  "requestOriginator": {
    object (RequestOriginator)
  }
}
ক্ষেত্র
requestHeader

object ( RequestHeader )

প্রয়োজনীয় : সমস্ত অনুরোধের জন্য সাধারণ শিরোনাম।

paymentLookupCriteria

object ( PaymentLookupCriteria )

প্রয়োজনীয় : এই তদন্তের জন্য যে অর্থপ্রদানের বিষয়টি দেখা হবে তা নির্দেশ করে।

existingGoogleClaimId

string

ঐচ্ছিক : একটি Google-উত্পাদিত স্ট্রিং যা একটি পূর্ববর্তী কল দ্বারা getDisputeInquiryReport যা স্বতন্ত্রভাবে এই গ্রাহকের বিরোধ দাবিকে সনাক্ত করে।

এটি উপস্থিত না থাকলে, একটি নতুন দাবি আইডি তৈরি করা হবে। কলকারী একটি googleClaimId প্রদান করতে পারে যা getDisputeInquiryReport এ পূর্ববর্তী কলের মাধ্যমে ফেরত দেওয়া হয়েছিল যদি এটি একই গ্রাহক বিবাদের ধারাবাহিকতা হয়।

এখানে যে দাবির আইডি তৈরি করা হয়েছে বা তৈরি করা হয়েছে তা প্রতিক্রিয়ার googleClaimId ক্ষেত্রে ফেরত দেওয়া হবে।

একটি googleClaimId প্রদান করা বৈধ নয় যা getDisputeInquiryReport এ পূর্ববর্তী কল দ্বারা ফেরত আসেনি। এটি ঘটলে, HTTP 400 খারাপ অনুরোধ ফেরত দেওয়া হবে।

requestOriginator

object ( RequestOriginator )

প্রয়োজনীয় : এই অনুরোধের উদ্ভবকারী সংস্থা বা সাংগঠনিক উপ-গ্রুপ সম্পর্কে তথ্য।

প্রতিক্রিয়া শরীর

এই পদ্ধতি একাধিক রিটার্ন প্রকার সমর্থন করে। 4XX বা 5XX HTTP স্ট্যাটাস কোড কোন ErrorResponse দিয়ে ফেরত দিতে হবে সে সম্পর্কে অতিরিক্ত তথ্যের জন্য, ErrorResponse অবজেক্ট এবং HTTP স্ট্যাটাস কোড ডকুমেন্টেশন দেখুন।

এই পদ্ধতি একাধিক রিটার্ন প্রকার সমর্থন করে। 4XX বা 5XX HTTP স্ট্যাটাস কোড কোন ErrorResponse দিয়ে ফেরত দিতে হবে সে সম্পর্কে অতিরিক্ত তথ্যের জন্য, ErrorResponse অবজেক্ট এবং HTTP স্ট্যাটাস কোড ডকুমেন্টেশন দেখুন।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

সম্ভাব্য প্রতিক্রিয়া বার্তা
HTTP 200 স্থিতি

object ( GetDisputeInquiryReportResponse )

HTTP 4XX / 5XX স্থিতি

object ( ErrorResponse )

অনুরোধ শিরোনাম

হেডার অবজেক্ট যা সার্ভারে পাঠানো সমস্ত অনুরোধে সংজ্ঞায়িত করা হয়।

JSON প্রতিনিধিত্ব
{
  "requestId": string,
  "requestTimestamp": {
    object (Timestamp)
  },
  "protocolVersion": {
    object (Version)
  },
  "paymentIntegratorAccountId": string
}
ক্ষেত্র
requestId

string

প্রয়োজনীয় : এই অনুরোধের অনন্য শনাক্তকারী।

এটি এমন একটি স্ট্রিং যার সর্বোচ্চ দৈর্ঘ্য 100টি অক্ষর, এবং এতে শুধুমাত্র "az", "AZ", "0-9", ":", "-", এবং "_" অক্ষর রয়েছে।

requestTimestamp

object ( Timestamp )

প্রয়োজনীয় : এই অনুরোধের টাইমস্ট্যাম্প। প্রাপককে অবশ্যই যাচাই করতে হবে যে এই টাইমস্ট্যাম্পটি 'এখন' এর ± 60s, এবং যদি তা না হয় তবে অনুরোধটি প্রত্যাখ্যান করুন। এই অনুরোধ টাইমস্ট্যাম্প পুনঃপ্রচেষ্টার উপর অদম্য নয়।

protocolVersion

object ( Version )

প্রয়োজনীয় : এই অনুরোধের সংস্করণ।

paymentIntegratorAccountId

string

প্রয়োজনীয় : চুক্তির সীমাবদ্ধতা সহ একটি অনন্য অ্যাকাউন্ট সনাক্ত করে।

টাইমস্ট্যাম্প

ইউনিক্স যুগ থেকে মিলিসেকেন্ডে ISO টাইমলাইনে একটি বিন্দুর প্রতিনিধিত্বকারী একটি টাইমস্ট্যাম্প বস্তু।

JSON প্রতিনিধিত্ব
{
  "epochMillis": string
}
ক্ষেত্র
epochMillis

string ( Int64Value format)

প্রয়োজনীয় : ইউনিক্স যুগ থেকে মিলিসেকেন্ড

সংস্করণ

সংস্করণ অবজেক্টে API এর প্রধান সংস্করণ রয়েছে। একই প্রধান সংস্করণের সংস্করণগুলি সামঞ্জস্যপূর্ণ হওয়ার গ্যারান্টিযুক্ত। ইন্টিগ্রেটরকে অবশ্যই একই প্রধান সংস্করণের জন্য সমস্ত অনুরোধ সমর্থন করতে হবে।

JSON প্রতিনিধিত্ব
{
  "major": integer
}
ক্ষেত্র
major

integer

প্রয়োজনীয় : প্রধান সংস্করণ। এটি বিভিন্ন সংস্করণের সাথে সামঞ্জস্যের অনুরোধগুলির জন্য চিহ্নিত করা হয়েছে যেগুলি সামঞ্জস্যপূর্ণ হওয়ার নিশ্চয়তা নেই৷

পেমেন্ট লুকআপ মানদণ্ড

মানদণ্ডের জন্য ধারক যা অনন্যভাবে একটি অর্থপ্রদানের সন্ধান করতে পারে। একটি (এবং শুধুমাত্র একটি) সদস্য ক্ষেত্র জনবহুল হতে হবে।

JSON প্রতিনিধিত্ব
{

  // Union field criteria can be only one of the following:
  "arnCriteria": {
    object (ArnCriteria)
  },
  "googleTransactionReferenceNumberCriteria": {
    object (GoogleTransactionReferenceNumberCriteria)
  },
  "captureRequestCriteria": {
    object (CaptureRequestCriteria)
  }
  // End of list of possible types for union field criteria.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের criteria ।

criteria নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

arnCriteria

object ( ArnCriteria )

ঐচ্ছিক : Acquirer রেফারেন্স নম্বর (ARN) এর উপর ভিত্তি করে সন্ধান করুন।

googleTransactionReferenceNumberCriteria

object ( GoogleTransactionReferenceNumberCriteria )

ঐচ্ছিক : Google লেনদেন রেফারেন্স নম্বরের উপর ভিত্তি করে সন্ধান করুন।

captureRequestCriteria

object ( CaptureRequestCriteria )

ঐচ্ছিক : মূল ক্যাপচার অনুরোধের উপর ভিত্তি করে সন্ধান করুন।

ArnCriteria

অ্যাকুয়ারার রেফারেন্স নম্বর (ARN) এর উপর ভিত্তি করে অর্থপ্রদানের সন্ধানের মানদণ্ড।

JSON প্রতিনিধিত্ব
{
  "acquirerReferenceNumber": string,
  "authorizationCode": string
}
ক্ষেত্র
acquirerReferenceNumber

string

প্রয়োজনীয় : অ্যাকুইয়ারার রেফারেন্স নম্বর (ARN) যা পেমেন্টটিকে অনন্যভাবে শনাক্ত করে। 23 সংখ্যা দীর্ঘ হতে হবে।

authorizationCode

string

প্রয়োজনীয় : লেনদেনের জন্য অনুমোদন কোড।

GoogleTransactionReferenceNumberCriteria

Google-উত্পাদিত লেনদেন রেফারেন্স নম্বরের উপর ভিত্তি করে অর্থপ্রদানের সন্ধানের মানদণ্ড।

JSON প্রতিনিধিত্ব
{
  "googleTransactionReferenceNumber": string,
  "authorizationCode": string
}
ক্ষেত্র
googleTransactionReferenceNumber

string

প্রয়োজনীয় : Google-এর তৈরি ট্রানজ্যাকশন রেফারেন্স নম্বর যা পেমেন্টটিকে অনন্যভাবে শনাক্ত করে।

authorizationCode

string

প্রয়োজনীয় : লেনদেনের জন্য অনুমোদন কোড।

ক্যাপচার অনুরোধের মানদণ্ড

মূল ক্যাপচার অনুরোধের উপর ভিত্তি করে পেমেন্ট সন্ধানের মানদণ্ড।

JSON প্রতিনিধিত্ব
{
  "captureRequestId": string
}
ক্ষেত্র
captureRequestId

string

প্রয়োজনীয় : এই লেনদেনের জন্য একটি অনন্য শনাক্তকারী। এটি capture কলের সময় Google দ্বারা তৈরি করা requestId যা খোঁজা হচ্ছে৷

RequestOriginator

প্রতিষ্ঠান বা সাংগঠনিক সাব-গ্রুপ এবং ঐচ্ছিকভাবে কর্মচারী সম্পর্কে তথ্য, যেখান থেকে এই অনুরোধটি এসেছে। এটি Google-কে সমস্যা বা অপব্যবহার শনাক্ত করতে এবং paymentIntegratorAccountId এর চেয়ে সূক্ষ্ম স্তরে নিয়ন্ত্রণ প্রয়োগ করতে দেয়। এটি বিশেষভাবে মূল্যবান যখন বলা হয় একটি মধ্যস্থতাকারী পরিষেবা প্রদানকারী যেটি একাধিক বহিরাগত ক্লায়েন্টদের কাছ থেকে অনুরোধ করে।

JSON প্রতিনিধিত্ব
{
  "organizationId": string,
  "organizationDescription": string,
  "agentId": string
}
ক্ষেত্র
organizationId

string

প্রয়োজনীয় : কোম্পানি, সংস্থা বা সাংগঠনিক গোষ্ঠীর একটি শনাক্তকারী যেখান থেকে এই অনুরোধটি এসেছে৷ এই paymentIntegratorAccountId এর মধ্যে অনন্য হতে হবে।

organizationDescription

string

প্রয়োজনীয় : একটি মানব-পঠনযোগ্য নাম বা সংস্থার বিবরণ যা Google-এর কর্মচারী এবং সেই সংস্থার সংহতকারীর মধ্যে যোগাযোগ সহজ করতে ব্যবহার করা যেতে পারে৷

agentId

string

ঐচ্ছিক : organizationId দ্বারা চিহ্নিত প্রতিষ্ঠানের নির্দিষ্ট এজেন্টের (কর্মচারী) জন্য একটি অনন্য শনাক্তকারী যার থেকে এই অনুরোধটি এসেছে। এই organizationId মধ্যে অনন্য হতে হবে।

GetDisputeInquiryReportResponse

getDisputeInquiryReport পদ্ধতির জন্য প্রতিক্রিয়া পেলোড।

JSON প্রতিনিধিত্ব
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": {
    object (GetDisputeInquiryReportResult)
  }
}
ক্ষেত্র
responseHeader

object ( ResponseHeader )

প্রয়োজনীয় : সমস্ত প্রতিক্রিয়ার জন্য সাধারণ শিরোনাম।

result

object ( GetDisputeInquiryReportResult )

প্রয়োজনীয় : এই কলের ফলাফল।

রেসপন্স হেডার

হেডার অবজেক্ট যা সার্ভার থেকে প্রেরিত সমস্ত প্রতিক্রিয়াতে সংজ্ঞায়িত করা হয়।

JSON প্রতিনিধিত্ব
{
  "responseTimestamp": {
    object (Timestamp)
  }
}
ক্ষেত্র
responseTimestamp

object ( Timestamp )

প্রয়োজনীয় : এই প্রতিক্রিয়ার টাইমস্ট্যাম্প। প্রাপককে অবশ্যই যাচাই করতে হবে যে এই টাইমস্ট্যাম্পটি 'এখন' এর ± 60s, এবং যদি তা না হয় তবে প্রতিক্রিয়া প্রত্যাখ্যান করুন।

বিতর্ক অনুসন্ধান প্রতিবেদন ফলাফল পান

JSON প্রতিনিধিত্ব
{

  // Union field result can be only one of the following:
  "success": {
    object (SuccessDetails)
  },
  "paymentNotFound": {
    object (Empty)
  },
  "paymentTooOld": {
    object (Empty)
  },
  "orderCannotBeReturned": {
    object (Empty)
  },
  "noAdditionalDetails": {
    object (Empty)
  }
  // End of list of possible types for union field result.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের result ।

result শুধুমাত্র নিম্নলিখিত একটি হতে পারে:

success

object ( SuccessDetails )

পেমেন্ট পাওয়া গেছে এবং একটি রিপোর্ট প্রদান করা হয়.

paymentNotFound

object ( Empty )

অনুরোধকৃত অর্থপ্রদান পাওয়া যায়নি।

paymentTooOld

object ( Empty )

অনুরোধকৃত অর্থপ্রদান পাওয়া গেছে, কিন্তু অর্থপ্রদানের বয়সের কারণে একটি প্রতিবেদন প্রদান করা হয়নি।

orderCannotBeReturned

object ( Empty )

অনুরোধকৃত অর্থপ্রদান একটি অর্ডারের অন্তর্গত যা বিদ্যমান, কিন্তু ফেরত দেওয়া যাবে না। কারণগুলির মধ্যে রয়েছে এমন ক্ষেত্রে যেখানে অর্ডারটি তার মালিকের অনুরোধে সরানো হয়েছিল।

noAdditionalDetails

object ( Empty )

অনুরোধকৃত অর্থপ্রদান পাওয়া গেছে, কিন্তু একটি প্রতিবেদন পাওয়া যায় নি।

সাফল্যের বিবরণ

JSON প্রতিনিধিত্ব
{
  "googleClaimId": string,
  "report": {
    object (PurchaseReport)
  }
}
ক্ষেত্র
googleClaimId

string

প্রয়োজনীয় : একটি Google-উত্পাদিত স্ট্রিং যা অনন্যভাবে এই গ্রাহক বিরোধকে চিহ্নিত করে৷

যদি existingGoogleClaimId অনুরোধে পূরণ করা হয়, তাহলে এটি একই মান হবে। অন্যথায়, এটি একটি নতুন উত্পন্ন মান হবে। এই মানটি ভবিষ্যতে getDisputeInquiryReport অনুরোধে প্রদান করা যেতে পারে যদি তারা একই গ্রাহক বিরোধের অংশ হয়।

report

object ( PurchaseReport )

প্রয়োজনীয় : অনুরোধে চিহ্নিত অর্থপ্রদানের বিরোধের সাথে প্রাসঙ্গিক বিশদ বিবরণ।

ক্রয় প্রতিবেদন

অনুরোধকৃত অর্থপ্রদানের সাথে সম্পর্কিত ক্রয়ের প্রাসঙ্গিক বিবরণ ধারণকারী একটি প্রতিবেদন।

JSON প্রতিনিধিত্ব
{
  "customerAccount": {
    object (CustomerAccount)
  },
  "order": {
    object (Order)
  },
  "payment": {
    object (Payment)
  }
}
ক্ষেত্র
customerAccount

object ( CustomerAccount )

প্রয়োজনীয় : গ্রাহক এবং তাদের অ্যাকাউন্ট সম্পর্কিত তথ্য।

order

object ( Order )

ঐচ্ছিক : যে অর্ডারে অর্থপ্রদান করা হয়েছে সেই সংক্রান্ত তথ্য। সব ক্রয় রিপোর্টের জন্য উপলব্ধ নয়.

payment

object ( Payment )

প্রয়োজনীয় : পেমেন্ট সংক্রান্ত তথ্য। দ্রষ্টব্য: একক অর্ডারে একাধিক অর্থপ্রদান সম্ভব, কিন্তু এতে শুধুমাত্র মূল অনুরোধে চিহ্নিত অর্থপ্রদানের তথ্য থাকবে।

ক্রেতার হিসাব

গ্রাহকের অ্যাকাউন্ট সম্পর্কে তথ্য।

JSON প্রতিনিধিত্ব
{
  "customerEmail": string,
  "customerName": string
}
ক্ষেত্র
customerEmail

string

ঐচ্ছিক : গ্রাহকের Google অ্যাকাউন্টের সাথে যুক্ত ইমেল ঠিকানা।

customerName

string

প্রয়োজনীয় : গ্রাহকের নাম।

অর্ডার

আদেশ সম্পর্কে তথ্য.

JSON প্রতিনিধিত্ব
{
  "timestamp": {
    object (Timestamp)
  },
  "orderId": string,
  "subTotalAmount": {
    object (Amount)
  },
  "totalAmount": {
    object (Amount)
  },
  "shippingAddress": {
    object (Address)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "taxes": [
    {
      object (Tax)
    }
  ]
}
ক্ষেত্র
timestamp

object ( Timestamp )

প্রয়োজনীয় : কখন অর্ডার করা হয়েছিল তার টাইমস্ট্যাম্প।

orderId

string

প্রয়োজনীয় : একটি স্ট্রিং অনন্যভাবে এই অর্ডারটি সনাক্ত করে৷

subTotalAmount

object ( Amount )

প্রয়োজনীয় : ট্যাক্সের আগে এই অর্ডারের মোট পরিমাণ।

totalAmount

object ( Amount )

প্রয়োজনীয় : ট্যাক্স সহ এই অর্ডারের মোট পরিমাণ।

shippingAddress

object ( Address )

ঐচ্ছিক : এই ক্রমে ভৌত আইটেম জন্য শিপিং ঠিকানা.

items[]

object ( Item )

প্রয়োজনীয় : এই অর্ডারের অংশ ছিল এমন আইটেমগুলির তালিকা৷

taxes[]

object ( Tax )

প্রয়োজনীয় : করের তালিকা যা এই আদেশের অংশ ছিল। এই তালিকা খালি হতে পারে.

পরিমাণ

একটি মুদ্রা কোডের সাথে মাইক্রোতে একটি পরিমাণ যুক্ত করে।

JSON প্রতিনিধিত্ব
{
  "amountMicros": string,
  "currencyCode": string
}
ক্ষেত্র
amountMicros

string ( Int64Value format)

প্রয়োজনীয় : মাইক্রোতে একটি পরিমাণ।

currencyCode

string

প্রয়োজনীয় : ISO 4217 3-অক্ষরের মুদ্রা কোড

ঠিকানা

একটি প্রকৃত ঠিকানা সম্পর্কে তথ্য ধারণ করা কাঠামো।

JSON প্রতিনিধিত্ব
{
  "addressLine": [
    string
  ],
  "localityName": string,
  "administrativeAreaName": string,
  "postalCodeNumber": string,
  "countryCode": string
}
ক্ষেত্র
addressLine[]

string

ঐচ্ছিক : এটি অসংগঠিত ঠিকানা পাঠ্য ধারণ করে।

localityName

string

ঐচ্ছিক : এটি একটি অস্পষ্ট শব্দ, কিন্তু এটি সাধারণত একটি ঠিকানার শহর/শহরের অংশকে বোঝায়। বিশ্বের এমন অঞ্চলে যেখানে লোকালয়টি ভালভাবে সংজ্ঞায়িত করা হয় না বা এই কাঠামোর সাথে ভালভাবে ফিট করে না (উদাহরণস্বরূপ, জাপান এবং চীন), localityName খালি রাখুন এবং addressLine ব্যবহার করুন।

উদাহরণ: ইউএস সিটি, আইটি কমিউন, ইউকে পোস্ট টাউন।

administrativeAreaName

string

ঐচ্ছিক : এই দেশের শীর্ষ-স্তরের প্রশাসনিক উপবিভাগ" উদাহরণ: মার্কিন রাজ্য, আইটি অঞ্চল, সিএন প্রদেশ, জেপি প্রিফেকচার।"

postalCodeNumber

string

ঐচ্ছিক : নাম থাকা সত্ত্বেও, postalCodeNumber মানগুলি প্রায়শই আলফানিউমেরিক হয়৷ উদাহরণ: "94043", "SW1W", "SW1W 9TQ"।

countryCode

string

ঐচ্ছিক : গ্রাহকের ঠিকানা দেশের কোড, ISO-3166-1 আলফা-2 হতে পারে।

আইটেম

অর্ডার একটি আইটেম সম্পর্কে তথ্য.

JSON প্রতিনিধিত্ব
{
  "description": string,
  "merchant": string,
  "quantity": string,
  "totalPrice": {
    object (Amount)
  },
  "googleProductName": string
}
ক্ষেত্র
description

string

প্রয়োজনীয় : যে আইটেমটি কেনা হয়েছিল তার বিবরণ।

merchant

string

প্রয়োজনীয় : বিক্রেতা, শিল্পী, বা আইটেম নির্মাতা।

quantity

string ( Int64Value format)

ঐচ্ছিক : এই আইটেমটির অর্ডার দেওয়া পরিমাণ।

এই ক্ষেত্রটি বাদ দেওয়া হবে যদি পূর্ণসংখ্যার পরিমাণ পণ্যের জন্য প্রযোজ্য না হয় (উদাহরণস্বরূপ মিটারযুক্ত পণ্যগুলিতে ভগ্নাংশের পরিমাণ থাকতে পারে)।

totalPrice

object ( Amount )

প্রয়োজনীয় : এই আইটেমটির মোট মূল্য।

googleProductName

string

প্রয়োজনীয় : আইটেমের জন্য Google পণ্য পরিষেবার নাম৷

ট্যাক্স

এই আদেশে প্রযোজ্য ট্যাক্স সম্পর্কিত তথ্য।

JSON প্রতিনিধিত্ব
{
  "description": string,
  "amount": {
    object (Amount)
  }
}
ক্ষেত্র
description

string

প্রয়োজনীয় : করের বিবরণ।

amount

object ( Amount )

প্রয়োজনীয় : করের পরিমাণ।

পেমেন্ট

পেমেন্ট সম্পর্কে তথ্য.

JSON প্রতিনিধিত্ব
{
  "billingAddress": {
    object (Address)
  },
  "amount": {
    object (Amount)
  },
  "refunds": [
    {
      object (Refund)
    }
  ],

  // Union field fopDetails can be only one of the following:
  "cardDetails": {
    object (PaymentCardDetails)
  }
  // End of list of possible types for union field fopDetails.
}
ক্ষেত্র
billingAddress

object ( Address )

প্রয়োজনীয় : এই অর্থপ্রদানের জন্য বিলিং ঠিকানা।

amount

object ( Amount )

প্রয়োজনীয় : এই অর্থপ্রদানের পরিমাণ।

refunds[]

object ( Refund )

প্রয়োজনীয় : এই অর্থপ্রদানে করা ফেরতের তালিকা। এই তালিকা খালি হতে পারে.

ইউনিয়ন ক্ষেত্র fopDetails .

fopDetails নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

cardDetails

object ( PaymentCardDetails )

ঐচ্ছিক : ক্রেডিট এবং ডেবিট কার্ড FoPs-এর জন্য নির্দিষ্ট অর্থপ্রদানের বিবরণ।

ফেরত

একটি অর্থপ্রদানের উপর করা রিফান্ড সম্পর্কে তথ্য।

JSON প্রতিনিধিত্ব
{
  "amount": {
    object (Amount)
  },
  "initiatedTimestamp": {
    object (Timestamp)
  }
}
ক্ষেত্র
amount

object ( Amount )

প্রয়োজনীয় : ফেরত দেওয়া পরিমাণ।

initiatedTimestamp

object ( Timestamp )

প্রয়োজনীয় : ফেরত কখন শুরু করা হয়েছিল তার টাইমস্ট্যাম্প।

পেমেন্টকার্ডের বিবরণ

ক্রেডিট এবং ডেবিট কার্ডের জন্য নির্দিষ্ট অর্থপ্রদানের বিবরণ।

JSON প্রতিনিধিত্ব
{
  "authResult": enum (AuthResult)
}
ক্ষেত্র
authResult

enum ( AuthResult )

প্রয়োজনীয় : অর্থপ্রদান প্রমাণের ফলাফল।

প্রমাণ ফলাফল

পেমেন্ট প্রমাণীকরণ ফলাফল.

Enums
UNKNOWN_RESULT এই ডিফল্ট মান সেট করবেন না.
APPROVED প্রমাণীকরণ অনুমোদিত।
DENIED Auth অস্বীকার.
NOT_ATTEMPTED প্রমাণ করার চেষ্টা করা হয়নি।

খালি

এই ধরনের কোন ক্ষেত্র নেই.

এই বস্তুটি এক্সটেনসিবিলিটির জন্য ব্যবহার করা হয় কারণ বুলিয়ান এবং গণনা প্রায়ই অতিরিক্ত ডেটা সহ প্রসারিত করতে হয়। বাস্তবায়নকারী উপস্থিতি নির্ধারণ করতে এটি ব্যবহার করে। এটি যে গণনাটি উপস্থাপন করে তা ভবিষ্যতের সংস্করণগুলিতে ডেটা ধারণ করার জন্য প্রসারিত হতে পারে।

Empty জন্য JSON প্রতিনিধিত্ব খালি JSON অবজেক্ট {} ।

ত্রুটি প্রতিক্রিয়া

সমস্ত পদ্ধতির জন্য ত্রুটি প্রতিক্রিয়া অবজেক্ট।

JSON প্রতিনিধিত্ব
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "errorDescription": string,
  "paymentIntegratorErrorIdentifier": string,
  "errorResponseResult": {
    object (ErrorResponseResult)
  }
}
ক্ষেত্র
responseHeader

object ( ResponseHeader )

প্রয়োজনীয় : সমস্ত প্রতিক্রিয়ার জন্য সাধারণ শিরোনাম।

errorDescription

string

ঐচ্ছিক : ডিবাগ ত্রুটির জন্য সমর্থন প্রতিনিধিদের জন্য এই অবস্থার একটি বিবরণ প্রদান করুন। নোট করুন যে এটি ব্যবহারকারীদের কখনই দেখানো হয় না। এটিতে ডিবাগিংয়ের জন্য ব্যবহৃত বর্ণনামূলক, অ-সংবেদনশীল পাঠ্য থাকতে পারে। মনে রাখবেন যে errorResponseCode-এর জন্য কিছু মান এই ক্ষেত্রে অতিরিক্ত বিবরণের সাথে থাকা উচিত। সতর্কতা: এই বার্তাটিতে কোনো টোকেন অন্তর্ভুক্ত করবেন না যদি না সেগুলিকে সর্বজনীন হিসাবে সংজ্ঞায়িত করা হয়।

paymentIntegratorErrorIdentifier

string

ঐচ্ছিক : এই শনাক্তকারীটি ইন্টিগ্রেটরের জন্য নির্দিষ্ট এবং ইন্টিগ্রেটর দ্বারা তৈরি করা হয়। এটি শুধুমাত্র এই কল সনাক্ত করার জন্য ডিবাগিং উদ্দেশ্যে ব্যবহার করা হয়। এটি সেই শনাক্তকারী যা ইন্টিগ্রেটর এই কলটি জানে।

errorResponseResult

object ( ErrorResponseResult )

ঐচ্ছিক : একটি কোড যা ঘটে যাওয়া ত্রুটির ধরন ক্যাপচার করে।

Errorresponse Result

ত্রুটি কোড

JSON প্রতিনিধিত্ব
{

  // Union field result can be only one of the following:
  "invalidApiVersion": {
    object (InvalidApiVersion)
  },
  "invalidPayloadSignature": {
    object (InvalidPayloadSignature)
  },
  "invalidPayloadEncryption": {
    object (InvalidPayloadEncryption)
  },
  "requestTimestampOutOfRange": {
    object (RequestTimestampOutOfRange)
  },
  "invalidIdentifier": {
    object (InvalidIdentifier)
  },
  "idempotencyViolation": {
    object (IdempotencyViolation)
  },
  "invalidFieldValue": {
    object (InvalidFieldValue)
  },
  "missingRequiredField": {
    object (MissingRequiredField)
  },
  "preconditionViolation": {
    object (PreconditionViolation)
  },
  "userActionInProgress": {
    object (UserActionInProgress)
  },
  "invalidDecryptedRequest": {
    object (InvalidDecryptedRequest)
  },
  "forbidden": {
    object (Forbidden)
  }
  // End of list of possible types for union field result.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের result ।

result শুধুমাত্র নিম্নলিখিত একটি হতে পারে:

invalidApiVersion

object ( InvalidApiVersion )

অনুরোধের API সংস্করণ অসমর্থিত হলে ব্যবহার করা হয়। পরামর্শ দেওয়া HTTP কোড: 400

invalidPayloadSignature

object ( InvalidPayloadSignature )

পেলোডের স্বাক্ষর একটি অজানা বা নিষ্ক্রিয় কী-তে হলে ব্যবহৃত হয়। পরামর্শ দেওয়া HTTP কোড: 401

invalidPayloadEncryption

object ( InvalidPayloadEncryption )

যদি পেলোডের এনক্রিপশন একটি অজানা বা নিষ্ক্রিয় কী ব্যবহার করা হয়। পরামর্শ দেওয়া HTTP কোড: 400

requestTimestampOutOfRange

object ( RequestTimestampOutOfRange )

রিকোয়েস্ট টাইমস্ট্যাম্প এখন ± 60 না হলে ব্যবহার করা হয়। পরামর্শ দেওয়া HTTP কোড: 400

invalidIdentifier

object ( InvalidIdentifier )

অনুরোধে পাঠানো একটি শনাক্তকারী অবৈধ বা অজানা হলে ব্যবহার করা হয়। এর মধ্যে PIAID, captureRequestId, Google পেমেন্ট টোকেন ইত্যাদি অন্তর্ভুক্ত থাকতে পারে। পরামর্শ দেওয়া HTTP কোড: 404

idempotencyViolation

object ( IdempotencyViolation )

অনুরোধটি অনুরোধের জন্য অদম্যতা প্রয়োজনীয়তা লঙ্ঘন করলে ব্যবহৃত হয়। পরামর্শ দেওয়া HTTP কোড: 412

invalidFieldValue

object ( InvalidFieldValue )

যদি অনুরোধে একটি ফিল্ডের জন্য একটি মান থাকে যা সমর্থিত মানগুলির সেটে নেই তাহলে ব্যবহৃত হয়। পরামর্শ দেওয়া HTTP কোড: 400

missingRequiredField

object ( MissingRequiredField )

প্রয়োজনে একটি ক্ষেত্র অনুরোধে আনসেট হলে ব্যবহৃত হয়। পরামর্শ দেওয়া HTTP কোড: 400

preconditionViolation

object ( PreconditionViolation )

অপারেশনে একটি সীমাবদ্ধতা লঙ্ঘন করা হলে ব্যবহার করা হয় (উদাহরণস্বরূপ যখন ফেরতের পরিমাণের জন্য একটি অনুরোধ লেনদেনের অবশিষ্ট পরিমাণকে ছাড়িয়ে যায়)। পরামর্শ দেওয়া HTTP কোড: 400

userActionInProgress

object ( UserActionInProgress )

এই সময়ে অনুরোধটি প্রক্রিয়া করা না গেলে ব্যবহার করা হয় কারণ এটি একটি ইন-প্রসেস ব্যবহারকারী ক্রিয়াকে বাধা দেবে যা কার্যকরভাবে একটি সিস্টেম লক হিসাবে কাজ করে। বাস্তবায়ন-নির্দিষ্ট অভ্যন্তরীণ সঙ্গতি ত্রুটির কারণে ব্যর্থতা নির্দেশ করতে এই কোডটি ব্যবহার করা উচিত নয় । পরামর্শ দেওয়া HTTP কোড: 423

invalidDecryptedRequest

object ( InvalidDecryptedRequest )

অনুরোধ পেলোড ডিক্রিপ্ট করা গেলে ব্যবহার করা হয়, কিন্তু ফলস্বরূপ বার্তা পার্স করা যাবে না। পরামর্শ দেওয়া HTTP কোড: 400

forbidden

object ( Forbidden )

অনুরোধ করা সম্পদ অ্যাক্সেস নিষিদ্ধ. পরামর্শ দেওয়া Http কোড: 403

অবৈধApiVersion

JSON প্রতিনিধিত্ব
{
  "requestVersion": {
    object (Version)
  },
  "expectedVersion": {
    object (Version)
  }
}
ক্ষেত্র
requestVersion

object ( Version )

প্রয়োজনীয় : অনুরোধে নির্দিষ্ট করা অবৈধ সংস্করণ।

expectedVersion

object ( Version )

প্রয়োজনীয় : প্রত্যাশিত সংস্করণ।

অবৈধ পেলোড স্বাক্ষর

এই ধরনের কোন ক্ষেত্র আছে.

এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা যেতে পারে.

অবৈধ পেলোড এনক্রিপশন

এই ধরনের কোন ক্ষেত্র আছে.

এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা যেতে পারে.

টাইমস্ট্যাম্প আউট অফ রেঞ্জের অনুরোধ

JSON প্রতিনিধিত্ব
{
  "requestTimestamp": {
    object (Timestamp)
  },
  "serverTimestampAtReceipt": {
    object (Timestamp)
  }
}
ক্ষেত্র
requestTimestamp

object ( Timestamp )

প্রয়োজনীয় : অনুরোধে দেওয়া টাইমস্ট্যাম্প

serverTimestampAtReceipt

object ( Timestamp )

প্রয়োজনীয় : প্রাপ্তির সময়ে সার্ভারের সময়, তুলনা করার জন্য ব্যবহৃত হয়

অবৈধ শনাক্তকারী

JSON প্রতিনিধিত্ব
{
  "invalidIdentifierType": string
}
ক্ষেত্র
invalidIdentifierType

string

প্রয়োজনীয় : সনাক্তকারীর ধরন যা অবৈধ ছিল, যেমন PIAID, captureRequestId, ইত্যাদি।

অদম্যতা লঙ্ঘন

এই ধরনের কোন ক্ষেত্র আছে.

এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা যেতে পারে.

অবৈধ ফিল্ড ভ্যালু

JSON প্রতিনিধিত্ব
{
  "invalidFieldName": string
}
ক্ষেত্র
invalidFieldName

string

প্রয়োজনীয় : যে ক্ষেত্রের নামটি অবৈধ বলে পাওয়া গেছে।

প্রয়োজনীয় ক্ষেত্র অনুপস্থিত

JSON প্রতিনিধিত্ব
{
  "missingFieldNames": [
    string
  ]
}
ক্ষেত্র
missingFieldNames[]

string

প্রয়োজনীয় : অনুপস্থিত ক্ষেত্রগুলির নাম৷

পূর্বশর্ত লঙ্ঘন

এই ধরনের কোন ক্ষেত্র আছে.

এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা যেতে পারে.

UserActionInProgress

এই ধরনের কোন ক্ষেত্র আছে.

এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা যেতে পারে.

InvalidDecryptedRequest

এই ধরনের কোন ক্ষেত্র আছে.

এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা যেতে পারে.

নিষিদ্ধ

এই ধরনের কোন ক্ষেত্র আছে.

এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা যেতে পারে.