- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- পেমেন্ট লুকআপ মানদণ্ড
- ArnCriteria
- GoogleTransactionReferenceNumberCriteria
- ক্যাপচার অনুরোধের মানদণ্ড
- RequestOriginator
- ডিসপুট ইনকোয়ারি রিপোর্ট রেজাল্ট কোড পান
- ক্রয় প্রতিবেদন
- গ্রাহক অ্যাকাউন্ট
- অর্ডার
- ঠিকানা
- আইটেম
- ট্যাক্স
- পেমেন্ট
- ফেরত
- পেমেন্টকার্ডের বিবরণ
- প্রমাণ ফলাফল
একটি প্রতিবেদন পান যা একটি অর্থ প্রদানের সম্ভাব্য বিরোধের বিষয়ে ব্যবহারকারীর সাথে গ্রাহক সহায়তা কথোপকথনের সুবিধার্থে তথ্য সরবরাহ করে।
অনুরোধটি প্রক্রিয়া করার সময় যদি এন্ডপয়েন্ট কোনো ত্রুটির সম্মুখীন হয়, তাহলে এই এন্ডপয়েন্ট থেকে পাওয়া প্রতিক্রিয়া হবে টাইপ।ErrorResponse
যদি এই পদ্ধতিটি HTTP 200 ফেরত না দেয় তবে এই প্রশ্নের উত্তরগুলি খালি হতে পারে৷ প্রতিক্রিয়ার অংশটি এমন পরিস্থিতিতে খালি থাকে যেখানে একটি স্পষ্ট বিবরণ সহ একটি আক্রমণকারীকে অন্যান্য ইন্টিগ্রেটরগুলির পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট শনাক্তকারীকে বুঝতে সাহায্য করার জন্য ব্যবহার করা যেতে পারে৷ এই পরিস্থিতিতে, যেখানে হয় সাইনিং কী মেলে না, পেমেন্ট ইন্টিগ্রেটর শনাক্তকারী পাওয়া যায়নি, বা এনক্রিপশন কী অজানা ছিল, এই পদ্ধতিটি একটি খালি বডি সহ HTTP 404 ফিরিয়ে দেবে। যদি অনুরোধ স্বাক্ষর যাচাই করা যায়, ত্রুটি সংক্রান্ত অতিরিক্ত তথ্য প্রতিক্রিয়া বডিতে ফেরত দেওয়া হবে।ErrorResponse
একটি উদাহরণ অনুরোধ এর মত দেখায়:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 1,
"revision": 0
},
"requestId": "HsKv5pvtQKTtz7rdcw1YqE",
"requestTimestamp": "1519996751331"
},
"paymentIntegratorAccountId": "InvisiCashUSA",
"paymentLookupCriteria": {
"googleTransactionReferenceNumberCriteria": {
"googleTransactionReferenceNumber": "714545417102363157911822",
"authorizationCode": "111111"
}
},
"existingGoogleClaimId": "138431383281",
"requestOriginator": {
"organizationId": "ISSUER_256",
"organizationDescription": "Community Bank of Some City",
"agentId": "982749"
}
}
একটি উদাহরণ প্রতিক্রিয়া মত দেখায়:
{
"responseHeader": {
"responseTimestamp": "1519996752221"
},
"result": "SUCCESS",
"googleClaimId": "138431383281",
"report": {
"customerAccount": {
"customerEmail": "example@gmail.com",
"customerName" : "Example Customer"
},
"order": {
"timestamp": "1517992525972",
"orderId": "SOP.8976-1234-1234-123456..99",
"currencyCode": "USD",
"subTotalAmount": "206990000",
"totalAmount": "212990000",
"shippingAddress": {
"name": "Example Customer",
"addressLine": ["123 Main St"],
"localityName": "Springfield",
"administrativeAreaName": "CO",
"postalCodeNumber": "80309",
"countryCode": "US"
},
"taxes": [
{
"description": "Colorado Sales Tax",
"amount": "6000000"
}
],
"items": [
{
"description": "Super cool gizmo",
"merchant": "HTC",
"googleProductName": "Google Store",
"quantity": "2",
"totalPrice": "198000000"
},
{
"description": "Gizmo charger",
"merchant": "HTC",
"googleProductName": "Google Store",
"quantity": "1",
"totalPrice": "8990000"
}
]
},
"payment": {
"billingAddress" : {
"name": "Example Customer",
"addressLine": ["123 Main St"],
"localityName": "Springfield",
"administrativeAreaName": "CO",
"postalCodeNumber": "80309",
"countryCode": "US"
},
"amount": "100000000",
"refunds": [
{
"amount": "9250000",
"initiatedTimestamp": "1518811245384"
}
],
"cardDetails": {
"authResult": "APPROVED"
}
}
}
}
HTTP অনুরোধ
POST https://vgw.googleapis.com/secure-serving/gsp/v1/getDisputeInquiryReport/ :PIAID
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| JSON প্রতিনিধিত্ব |
|---|
{ "requestHeader": { object ( |
| ক্ষেত্র | |
|---|---|
requestHeader | প্রয়োজনীয় : সমস্ত অনুরোধের জন্য সাধারণ শিরোনাম। |
paymentIntegratorAccountId | প্রয়োজনীয় : পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট আইডেন্টিফায়ার যা এই ইন্টারঅ্যাকশনের জন্য কলকারী এবং সংশ্লিষ্ট চুক্তিগত সীমাবদ্ধতা সনাক্ত করে। |
paymentLookupCriteria | প্রয়োজনীয় : এই তদন্তের জন্য যে অর্থপ্রদানের বিষয়টি দেখা হবে তা নির্দেশ করে। |
existingGoogleClaimId | ঐচ্ছিক : একটি Google-উত্পাদিত স্ট্রিং যা একটি পূর্ববর্তী কল দ্বারা এটি উপস্থিত না থাকলে, একটি নতুন দাবি আইডি তৈরি করা হবে। কলকারী একটি এখানে যে দাবির আইডি তৈরি করা হয়েছে বা তৈরি করা হয়েছে তা প্রতিক্রিয়ার একটি |
requestOriginator | প্রয়োজনীয় : এই অনুরোধের উদ্ভবকারী সংস্থা বা সাংগঠনিক উপ-গ্রুপ সম্পর্কে তথ্য। |
প্রতিক্রিয়া শরীর
getDisputeInquiryReport পদ্ধতির জন্য প্রতিক্রিয়া পেলোড।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
| JSON প্রতিনিধিত্ব |
|---|
{ "responseHeader": { object ( |
| ক্ষেত্র | |
|---|---|
responseHeader | প্রয়োজনীয় : সমস্ত প্রতিক্রিয়ার জন্য সাধারণ শিরোনাম। |
result | প্রয়োজনীয় : এই কলের ফলাফল। |
googleClaimId | ঐচ্ছিক : একটি Google-উত্পাদিত স্ট্রিং যা অনন্যভাবে এই গ্রাহক বিরোধকে চিহ্নিত করে৷ (যদি এবং শুধুমাত্র যদি |
report | ঐচ্ছিক : অনুরোধে চিহ্নিত অর্থপ্রদানের বিরোধের সাথে প্রাসঙ্গিক বিবরণ। (যদি এবং শুধুমাত্র |
পেমেন্ট লুকআপ মানদণ্ড
মানদণ্ডের জন্য ধারক যা অনন্যভাবে একটি অর্থপ্রদানের সন্ধান করতে পারে। একটি (এবং শুধুমাত্র একটি) সদস্য ক্ষেত্র জনবহুল হতে হবে।
| JSON প্রতিনিধিত্ব |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ক্ষেত্রের | |
arnCriteria | ঐচ্ছিক : Acquirer রেফারেন্স নম্বর (ARN) এর উপর ভিত্তি করে সন্ধান করুন। |
googleTransactionReferenceNumberCriteria | ঐচ্ছিক : Google লেনদেন রেফারেন্স নম্বরের উপর ভিত্তি করে সন্ধান করুন। |
captureRequestCriteria | ঐচ্ছিক : ক্যাপচার অনুরোধ আইডির উপর ভিত্তি করে সন্ধান করুন। |
ArnCriteria
অ্যাকুয়ারার রেফারেন্স নম্বর (ARN) এর উপর ভিত্তি করে অর্থপ্রদানের সন্ধানের মানদণ্ড।
| JSON প্রতিনিধিত্ব |
|---|
{ "acquirerReferenceNumber": string, "authorizationCode": string } |
| ক্ষেত্র | |
|---|---|
acquirerReferenceNumber | প্রয়োজনীয় : অ্যাকুইয়ারার রেফারেন্স নম্বর (ARN) যা পেমেন্টটিকে অনন্যভাবে শনাক্ত করে। 23 সংখ্যার লম্বা হতে হবে। |
authorizationCode | প্রয়োজনীয় : লেনদেনের জন্য অনুমোদন কোড। |
GoogleTransactionReferenceNumberCriteria
Google-উত্পাদিত লেনদেন রেফারেন্স নম্বরের উপর ভিত্তি করে অর্থপ্রদানের সন্ধানের মানদণ্ড।
| JSON প্রতিনিধিত্ব |
|---|
{ "googleTransactionReferenceNumber": string, "authorizationCode": string } |
| ক্ষেত্র | |
|---|---|
googleTransactionReferenceNumber | প্রয়োজনীয় : Google-এর তৈরি ট্রানজ্যাকশন রেফারেন্স নম্বর যা পেমেন্টটিকে অনন্যভাবে শনাক্ত করে। |
authorizationCode | প্রয়োজনীয় : লেনদেনের জন্য অনুমোদন কোড। |
ক্যাপচার অনুরোধের মানদণ্ড
মূল ক্যাপচার অনুরোধের উপর ভিত্তি করে পেমেন্ট সন্ধানের মানদণ্ড।
| JSON প্রতিনিধিত্ব |
|---|
{ "captureRequestId": string } |
| ক্ষেত্র | |
|---|---|
captureRequestId | প্রয়োজনীয় : এই লেনদেনের জন্য একটি অনন্য শনাক্তকারী। এটি |
RequestOriginator
প্রতিষ্ঠান বা সাংগঠনিক সাব-গ্রুপ এবং ঐচ্ছিকভাবে কর্মচারী সম্পর্কে তথ্য, যেখান থেকে এই অনুরোধটি এসেছে। এটি Google-কে সমস্যা বা অপব্যবহার শনাক্ত করতে এবং paymentIntegratorAccountId এর চেয়ে সূক্ষ্ম স্তরে নিয়ন্ত্রণ প্রয়োগ করতে দেয়। এটি বিশেষভাবে মূল্যবান যখন কলার একজন মধ্যস্থতাকারী পরিষেবা প্রদানকারী হয় যেটি একাধিক বহিরাগত ক্লায়েন্টদের কাছ থেকে অনুরোধগুলি উৎসর্গ করে।
| JSON প্রতিনিধিত্ব |
|---|
{ "organizationId": string, "organizationDescription": string, "agentId": string } |
| ক্ষেত্র | |
|---|---|
organizationId | প্রয়োজনীয় : কোম্পানি, সংস্থা বা সাংগঠনিক গোষ্ঠীর একটি শনাক্তকারী যেখান থেকে এই অনুরোধটি এসেছে৷ এই |
organizationDescription | প্রয়োজনীয় : একটি মানব-পঠনযোগ্য নাম বা সংস্থার বিবরণ যা Google-এর কর্মচারী এবং সেই সংস্থার সংহতকারীর মধ্যে যোগাযোগ সহজ করতে ব্যবহার করা যেতে পারে। |
agentId | ঐচ্ছিক : |
ডিসপুট ইনকোয়ারি রিপোর্ট রেজাল্ট কোড পান
getDisputeInquiryReport পদ্ধতি কলের ফলাফল।
| Enums | |
|---|---|
UNKNOWN_RESULT | এই ডিফল্ট মান সেট করবেন না! |
SUCCESS | পেমেন্ট পাওয়া গেছে এবং একটি রিপোর্ট প্রদান করা হয়. |
PAYMENT_NOT_FOUND | অনুরোধকৃত অর্থপ্রদান পাওয়া যায়নি। |
PAYMENT_TOO_OLD | অনুরোধকৃত অর্থপ্রদান পাওয়া গেছে, কিন্তু অর্থপ্রদানের বয়সের কারণে একটি প্রতিবেদন প্রদান করা হয়নি। |
ORDER_CANNOT_BE_RETURNED | অনুরোধকৃত অর্থপ্রদান একটি অর্ডারের অন্তর্গত যা বিদ্যমান, কিন্তু ফেরত দেওয়া যাবে না। কারণগুলির মধ্যে রয়েছে এমন ক্ষেত্রে যেখানে অর্ডারটি তার মালিকের অনুরোধে সরানো হয়েছিল। |
NO_ADDITIONAL_DETAILS | অনুরোধকৃত অর্থপ্রদান পাওয়া গেছে, কিন্তু একটি প্রতিবেদন পাওয়া যায় নি। |
ক্রয় প্রতিবেদন
অনুরোধকৃত অর্থপ্রদানের সাথে সম্পর্কিত ক্রয়ের প্রাসঙ্গিক বিবরণ ধারণকারী একটি প্রতিবেদন।
| JSON প্রতিনিধিত্ব |
|---|
{ "customerAccount": { object ( |
| ক্ষেত্র | |
|---|---|
customerAccount | প্রয়োজনীয় : গ্রাহক এবং তাদের অ্যাকাউন্ট সম্পর্কিত তথ্য। |
order | প্রয়োজনীয় : যে অর্ডারে অর্থপ্রদান করা হয়েছে সেই সংক্রান্ত তথ্য। |
payment | ঐচ্ছিক : অর্থপ্রদান সংক্রান্ত তথ্য। দ্রষ্টব্য: একক অর্ডারে একাধিক অর্থপ্রদান সম্ভব, কিন্তু এতে শুধুমাত্র মূল অনুরোধে চিহ্নিত অর্থপ্রদানের তথ্য থাকবে। সব অর্ডার ধরনের জন্য উপলব্ধ নয়. |
গ্রাহক অ্যাকাউন্ট
গ্রাহকের অ্যাকাউন্ট সম্পর্কে তথ্য
| JSON প্রতিনিধিত্ব |
|---|
{ "customerEmail": string, "customerName": string } |
| ক্ষেত্র | |
|---|---|
customerEmail | প্রয়োজনীয় : গ্রাহকের Google অ্যাকাউন্টের সাথে যুক্ত ইমেল ঠিকানা। |
customerName | প্রয়োজনীয় : গ্রাহকের নাম। |
অর্ডার
আদেশ সম্পর্কে তথ্য.
| JSON প্রতিনিধিত্ব |
|---|
{ "timestamp": string, "orderId": string, "currencyCode": string, "subTotalAmount": string, "totalAmount": string, "shippingAddress": { object ( |
| ক্ষেত্র | |
|---|---|
timestamp | ঐচ্ছিক : কখন অর্ডার করা হয়েছিল তার টাইমস্ট্যাম্প, যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপন করা হয়েছে। সব অর্ডার ধরনের জন্য উপলব্ধ নয়. |
orderId | ঐচ্ছিক : একটি স্ট্রিং অনন্যভাবে এই অর্ডারটি সনাক্ত করে। সব অর্ডার ধরনের জন্য উপলব্ধ নয়. |
currencyCode | ঐচ্ছিক : এই অর্ডারে সমস্ত পরিমাণের জন্য ISO 4217 3-অক্ষরের মুদ্রা কোড। সব অর্ডার ধরনের জন্য উপলব্ধ নয়. |
subTotalAmount | ঐচ্ছিক : ট্যাক্সের আগে এই অর্ডারের মোট পরিমাণ, |
totalAmount | ঐচ্ছিক : কর সহ এই অর্ডারের মোট পরিমাণ, যা |
shippingAddress | ঐচ্ছিক : এই ক্রমে ভৌত আইটেম জন্য শিপিং ঠিকানা. |
items[] | প্রয়োজনীয় : এই অর্ডারের অংশ ছিল এমন আইটেমগুলির তালিকা৷ |
taxes[] | প্রয়োজনীয় : এই অর্ডারের অংশ ছিল এমন আইটেমগুলির তালিকা৷ এই তালিকা খালি হতে পারে. |
ঠিকানা
একটি ঠিকানা সম্পর্কে তথ্য ধারণ করা কাঠামো.
| JSON প্রতিনিধিত্ব |
|---|
{ "name": string, "addressLine": [ string ], "localityName": string, "administrativeAreaName": string, "postalCodeNumber": string, "countryCode": string } |
| ক্ষেত্র | |
|---|---|
name | ঐচ্ছিক : গ্রাহকের পুরো নাম। |
addressLine[] | ঐচ্ছিক : এটি অসংগঠিত ঠিকানা পাঠ্য ধারণ করে। |
localityName | ঐচ্ছিক : এটি একটি অস্পষ্ট শব্দ, কিন্তু এটি সাধারণত একটি ঠিকানার শহর/শহরের অংশকে বোঝায়। বিশ্বের এমন অঞ্চলে যেখানে লোকালয়টি ভালভাবে সংজ্ঞায়িত করা হয় না বা এই কাঠামোর সাথে ভালভাবে ফিট করে না (উদাহরণস্বরূপ, জাপান এবং চীন), localityName খালি রাখুন এবং addressLine ব্যবহার করুন। উদাহরণ: ইউএস সিটি, আইটি কমিউন, ইউকে পোস্ট টাউন। |
administrativeAreaName | ঐচ্ছিক : এই দেশের শীর্ষ-স্তরের প্রশাসনিক উপবিভাগ" উদাহরণ: মার্কিন রাজ্য, আইটি অঞ্চল, সিএন প্রদেশ, জেপি প্রিফেকচার।" |
postalCodeNumber | ঐচ্ছিক : নাম থাকা সত্ত্বেও, postalCodeNumber মানগুলি প্রায়শই আলফানিউমেরিক হয়৷ উদাহরণ: "94043", "SW1W", "SW1W 9TQ"। |
countryCode | ঐচ্ছিক : গ্রাহকের ঠিকানা দেশের কোড, ISO-3166-1 আলফা-2 হতে পারে। |
আইটেম
অর্ডার একটি আইটেম সম্পর্কে তথ্য.
| JSON প্রতিনিধিত্ব |
|---|
{ "description": string, "merchant": string, "quantity": string, "totalPrice": string, "googleProductName": string } |
| ক্ষেত্র | |
|---|---|
description | ঐচ্ছিক : যে আইটেমটি কেনা হয়েছিল তার বিবরণ। সব অর্ডার ধরনের জন্য উপলব্ধ নয়. |
merchant | প্রয়োজনীয় : বিক্রেতা, শিল্পী, বা আইটেম নির্মাতা। |
quantity | ঐচ্ছিক : এই আইটেমটির অর্ডার দেওয়া পরিমাণ। এই ক্ষেত্রটি বাদ দেওয়া হবে যদি পূর্ণসংখ্যার পরিমাণ পণ্যের জন্য প্রযোজ্য না হয় (উদাহরণস্বরূপ মিটারযুক্ত পণ্যগুলিতে ভগ্নাংশের পরিমাণ থাকতে পারে)। |
totalPrice | ঐচ্ছিক : এই আইটেমটির মোট মূল্য, |
googleProductName | প্রয়োজনীয় : আইটেমের জন্য Google পণ্য পরিষেবার নাম। |
ট্যাক্স
এই আদেশের জন্য প্রযোজ্য একটি করের তথ্য।
| JSON প্রতিনিধিত্ব |
|---|
{ "description": string, "amount": string } |
| ক্ষেত্র | |
|---|---|
description | প্রয়োজনীয় : করের বিবরণ। |
amount | প্রয়োজনীয় : করের পরিমাণ, |
পেমেন্ট
পেমেন্ট সম্পর্কে তথ্য.
| JSON প্রতিনিধিত্ব |
|---|
{ "billingAddress": { object ( |
| ক্ষেত্র | |
|---|---|
billingAddress | প্রয়োজনীয় : এই অর্থপ্রদানের জন্য বিলিং ঠিকানা। |
amount | প্রয়োজনীয় : এই অর্থপ্রদানের পরিমাণ, |
refunds[] | প্রয়োজনীয় : এই অর্থপ্রদানে করা ফেরতের তালিকা। এই তালিকা খালি হতে পারে. |
ইউনিয়ন ক্ষেত্র | |
cardDetails | ঐচ্ছিক : ক্রেডিট এবং ডেবিট কার্ড FoPs-এর জন্য নির্দিষ্ট অর্থপ্রদানের বিবরণ। |
ফেরত
একটি অর্থপ্রদানের উপর করা রিফান্ড সম্পর্কে তথ্য।
| JSON প্রতিনিধিত্ব |
|---|
{ "amount": string, "initiatedTimestamp": string } |
| ক্ষেত্র | |
|---|---|
amount | প্রয়োজনীয় : ফেরত দেওয়া পরিমাণ, |
initiatedTimestamp | প্রয়োজনীয় : কখন ফেরত দেওয়া শুরু হয়েছিল তার টাইমস্ট্যাম্প, যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপিত। |
পেমেন্টকার্ডের বিবরণ
ক্রেডিট এবং ডেবিট কার্ডের জন্য নির্দিষ্ট অর্থপ্রদানের বিবরণ।
| JSON প্রতিনিধিত্ব |
|---|
{
"authResult": enum ( |
| ক্ষেত্র | |
|---|---|
authResult | প্রয়োজনীয় : অর্থপ্রদান প্রমাণের ফলাফল। |
প্রমাণ ফলাফল
পেমেন্ট প্রমাণীকরণ ফলাফল.
| Enums | |
|---|---|
UNKNOWN_RESULT | এই ডিফল্ট মান সেট করবেন না! |
APPROVED | প্রমাণীকরণ অনুমোদিত। |
DENIED | Auth অস্বীকার. |
NOT_ATTEMPTED | প্রমাণ করার চেষ্টা করা হয়নি। |