- HTTP isteği
- İstek metni
- Yanıt metni
- UpiDetails
- DisburseFundsResult
- DisburseFundsResultCode
- RawResult
Ödeme işleyici ile müşterinin hesabı arasında para aktarımı başlatır. Başlık içindeki requestId
ve paymentIntegratorAccountId
kombinasyonu kimlik anahtarıdır ve bu işlemi benzersiz şekilde tanımlar. Bu işlemdeki tüm mutasyonlar disburseFundsRequestId
alanındaki requestId
değerini doldurur.
Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktanın yanıt gövdesi
türünde olmalıdır.ErrorResponse
Örnek bir istek şu şekilde görünür:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "liUrreQY233839dfFFb24gaQM",
"requestTimestamp": "1502220434778"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"upiDetails": {
"vpa": "foo@icici"
},
"transactionDescription": "Google - Music",
"currencyCode": "INR",
"amount": "208000000"
}
Örnek bir yanıt şöyle görünür:
{
"responseHeader": {
"responseTimestamp": "1481900013178"
},
"paymentIntegratorTransactionId": "aW50ZWdyYXRvciB0cmFuc2FjdGlvbiBpZA",
"disburseFundsResult": {
"disburseFundsResultCode": "SUCCESS"
}
}
HTTP isteği
POST https://www.integratorhost.example.com/v1/disburseFunds
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{ "requestHeader": { object ( |
Alanlar | |
---|---|
requestHeader |
ZORUNLU: Tüm istekler için ortak başlık. |
paymentIntegratorAccountId |
ZORUNLU: Bu işlemle ilgili sözleşmeden doğan kısıtlamaları tanımlayan ödeme entegratörü hesap kimliğidir. |
transactionDescription |
ZORUNLU: Müşterinin ekstresine eklenebilecek işlem açıklamasıdır. |
currencyCode |
ZORUNLU: ISO 4217 3 harfli para birimi kodu |
amount |
ZORUNLU: Para biriminin mikro cinsinden satın alma tutarı. |
|
|
upiDetails |
İSTEĞE BAĞLI: UPI araçlarına özel ödeme ayrıntıları. |
Yanıt gövdesi
Ödeme fonları yöntemiyle ilgili yanıt nesnesi.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "responseHeader": { object ( |
Alanlar | |
---|---|
responseHeader |
ZORUNLU: Tüm yanıtlar için ortak başlık. |
paymentIntegratorTransactionId |
ZORUNLU: Bu tanımlayıcı entegratöre özeldir ve entegratör tarafından oluşturulur. Bu, entegratörün bu işlemi bildiği tanımlayıcıdır. Kolaylık sağlaması açısından bu tanımlayıcı havale ayrıntılarına eklenmiştir. |
disburseFundsResult |
ZORUNLU: Ödeme ödemesi çağrısının sonucu. |
UpiDetails
Ödeme yapılacak UPI hesabıyla ilgili ayrıntılar.
JSON gösterimi |
---|
{ "vpa": string } |
Alanlar | |
---|---|
vpa |
ZORUNLU: UPI protokolü kullanılarak para taşımak için kullanılan, kullanıcının Sanal Ödeme Adresi (VPA). Örneğin, foo@icici. |
DisburseFundsResult
Bir ödemenin nihai sonucuyla ilgili bilgiler.
JSON gösterimi |
---|
{ "disburseFundsResultCode": enum ( |
Alanlar | |
---|---|
disburseFundsResultCode |
ZORUNLU: Bu ödemenin sonuç kodu. |
rawResult |
İSTEĞE BAĞLI: Bu ödemenin ham sonucu. Google'ın risk motoru ve analizlerinin bilgilendirilmesine yardımcı olmak için kullanılır. Reddetme kodu eşleme durumlarında bazen veriler kaybolur. Entegratör, Google'a ham bir kod vermeyi tercih edebilir. Örneğin, bir kredi kartı ağ geçidi (entegre edici) bu alanı, VISA ağından alınan reddetme kodunu aynen Google'a iletmek için kullanabilir. Bu durumda,
|
|
|
transactionMaxLimit |
İSTEĞE BAĞLI: Bu miktar, orijinal |
transactionMinLimit |
İSTEĞE BAĞLI: Bu miktar, orijinal |
DisburseFundsResultCode
Ödeme yardımı araması için sonuç kodları.
Sıralamalar | |
---|---|
UNKNOWN_RESULT |
Bu varsayılan değeri hiçbir zaman ayarlamayın. |
SUCCESS |
Ödeme başarılı oldu. |
DISBURSEMENT_UNDER_TRANSACTION_LIMIT |
İstenen ödeme tutarı, entegratörün işlem başına minimum tutarını karşılamıyor. Bu kod kullanılırsa kullanıcının mesajlaşma amacıyla transactionMinLimit alanını minimum işlem tutarıyla doldurun. |
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT |
İstenen ödeme tutarı, entegratörün işlem başına maksimum sınırını aşıyor. Bu kod kullanılırsa kullanıcının mesajlaşma amacıyla transactionMaxLimit alanını işlem sınırıyla doldurun. |
ACCOUNT_CLOSED |
Kullanıcının entegratörde bulunan hesabı kapatıldı. Bu döndürülen değer, kullanıcının aracının Google tarafından kapatılmasına neden olur. Kullanıcı yeni bir araç eklemeye zorlanır. |
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER |
Kullanıcının entegratördeki hesabı kapatıldı ve hesabın ele geçirildiğinden şüpheleniliyor. Bu döndürülen değer, kullanıcının aracının Google tarafından kapatılmasına neden olur. Kullanıcı yeni bir araç eklemeye zorlanır. |
ACCOUNT_CLOSED_FRAUD |
Kullanıcının entegratörde tutulan hesabı sahtekarlık nedeniyle kapatıldı. Bu döndürülen değer, kullanıcının aracının Google tarafından kapatılmasına neden olur. Kullanıcı yeni bir araç eklemeye zorlanır. |
ACCOUNT_ON_HOLD |
Kullanıcının hesabı beklemede. |
RawResult
Ham sonuç nesnesi.
JSON gösterimi |
---|
{ "scope": string, "rawCode": string } |
Alanlar | |
---|---|
scope |
İSTEĞE BAĞLI: HamCode'un kapsamı boş olabilir. |
rawCode |
ZORUNLU: Entegratörden veya içindeki alt sistemlerden alınan ham kod. |