- درخواست HTTP
- درخواست بدن
- بدن پاسخگو
- Disburse Funds Result
- DisburseFundsResultCode
- RawResult
- DisburseFundsResultNotificationResultCode
پس از برقراری تماس روش disburseFunds
، نتیجه پرداخت را به Google اطلاع دهید.
مقدار disburseFundsResult
برای این disburseFundsRequestId
فاقد قدرت است، بنابراین مقدار آن باید با مقدار بازگردانده شده در طول فراخوانی disburseFunds
یکسان باشد و با فراخوانی بعدی به این روش قابل تغییر نیست.
اگر نقطه پایانی هنگام پردازش درخواست با خطا مواجه شود، پاسخ این نقطه پایانی از نوع
خواهد بود.ErrorResponse
اگر این روش یک HTTP 200 را برنگرداند، ممکن است پاسخهای این عبارت خالی باشد. بدنه پاسخ در شرایطی که میتوان از یک
با توضیح واضح برای کمک به مهاجم برای درک شناسه حساب یکپارچهساز پرداخت سایر ادغامکنندهها استفاده کرد، خالی است. در این شرایط، که یا کلید امضا مطابقت ندارد، شناسه یکپارچه پرداخت پیدا نشد، یا کلید رمزگذاری ناشناخته بود، این روش یک HTTP 404 را با بدنه خالی برمی گرداند. اگر امضای درخواست تأیید شود، اطلاعات اضافی در مورد خطا در بدنه پاسخ بازگردانده می شود.ErrorResponse
یک نمونه درخواست به نظر می رسد:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 1,
"revision": 0
},
"requestId": "KcgwSKrV76eVNDUbsZ4UA3",
"requestTimestamp": "1481852928293"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
"disburseFundsResult": {
"disburseFundsResultCode": "SUCCESS"
}
}
یک نمونه پاسخ به نظر می رسد:
{
"responseHeader": {
"responseTimestamp": "1481852928324"
},
"result": "SUCCESS"
}
درخواست HTTP
POST https://vgw.googleapis.com/secure-serving/gsp/v1/disburseFundsResultNotification/ :PIAID
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "requestHeader": { object ( |
زمینه های | |
---|---|
requestHeader | مورد نیاز : هدر مشترک برای همه درخواست ها. |
paymentIntegratorAccountId | مورد نیاز : شناسه حساب یکپارچه کننده پرداخت که پرداخت در آن انجام شده است. |
disburseFundsRequestId | مورد نیاز : یک شناسه منحصر به فرد برای این تراکنش. این این یک رشته با حداکثر طول 100 کاراکتر است و فقط شامل کاراکترهای "az"، "AZ"، "0-9"، ":"، "-"، و "_" است. |
disburseFundsResult | مورد نیاز : نتیجه این فراخوان پرداخت وجوه. |
بدن پاسخگو
شی پاسخ برای روش disburseFundsResultNotification
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "responseHeader": { object ( |
زمینه های | |
---|---|
responseHeader | مورد نیاز : هدر مشترک برای همه پاسخ ها. |
result | الزامی : نتیجه این تماس. |
Disburse Funds Result
اطلاعات در مورد نتیجه نهایی پرداخت.
نمایندگی JSON |
---|
{ "disburseFundsResultCode": enum ( |
زمینه های | |
---|---|
disburseFundsResultCode | مورد نیاز : کد نتیجه این پرداخت. |
rawResult | اختیاری : نتیجه خام این پرداخت. برای کمک به اطلاع رسانی به موتور ریسک و تجزیه و تحلیل Google استفاده می شود. در موقعیتهای نقشهبرداری کد کاهشی، دادهها گاهی از دست میروند. یکپارچهساز میتواند انتخاب کند که یک کد خام به Google بدهد. به عنوان مثال، یک دروازه کارت اعتباری (یکپارچه ساز) ممکن است از این فیلد برای برقراری ارتباط با Google کد رد دقیق دریافت شده از شبکه VISA استفاده کند. در آن صورت، اگر |
فیلد اتحادیه | |
transactionMaxLimit | اختیاری : اگر این مقدار میکرو همان |
transactionMinLimit | اختیاری : اگر این مقدار میکرو همان |
DisburseFundsResultCode
کدهای نتیجه برای تماس پرداخت وجوه.
Enums | |
---|---|
UNKNOWN_RESULT | هرگز این مقدار پیش فرض را تنظیم نکنید! |
SUCCESS | پرداخت با موفقیت انجام شد. |
DISBURSEMENT_UNDER_TRANSACTION_LIMIT | مبلغ پرداخت درخواستی با حداقل مبلغ ادغام کننده برای هر تراکنش مطابقت ندارد. اگر از این کد استفاده میشود، قسمت transactionMinLimit را با حداقل مبلغ تراکنش برای اهداف پیامرسانی کاربر پر کنید. |
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT | مبلغ پرداخت درخواستی از حداکثر حد مجاز برای هر تراکنش فراتر می رود. اگر از این کد استفاده میشود، قسمت transactionMaxLimit را با محدودیت تراکنش برای اهداف پیامرسانی کاربر پر کنید. |
ACCOUNT_CLOSED | حساب کاربری که با ادغام کننده نگهداری می شود بسته شده است. این مقدار بازگشتی باعث میشود که ابزار کاربر با Google بسته شود. کاربر مجبور می شود یک ابزار جدید اضافه کند. |
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER | حساب کاربر با یکپارچه بسته شده است، حساب مشکوک به تصرف در می آید. این مقدار بازگشتی باعث میشود که ابزار کاربر با Google بسته شود. کاربر مجبور می شود یک ابزار جدید اضافه کند. |
ACCOUNT_CLOSED_FRAUD | حساب کاربری که نزد integrator نگهداری می شود به دلیل کلاهبرداری بسته شده است. این مقدار بازگشتی باعث میشود که ابزار کاربر با Google بسته شود. کاربر مجبور می شود یک ابزار جدید اضافه کند. |
ACCOUNT_ON_HOLD | حساب کاربری در حالت تعلیق است. |
RawResult
شیء نتیجه خام.
نمایندگی JSON |
---|
{ "scope": string, "rawCode": string } |
زمینه های | |
---|---|
scope | اختیاری : محدوده rawCode، می تواند خالی باشد. |
rawCode | مورد نیاز : کد خام از یکپارچه ساز یا زیرسیستم های درون آن. |
DisburseFundsResultNotificationResultCode
کدهای نتیجه برای روش disburseFundsResultNotification
.
Enums | |
---|---|
UNKNOWN_RESULT | هرگز این مقدار پیش فرض را تنظیم نکنید! |
SUCCESS | اعلان با موفقیت پردازش شد. |