Method: refund

capture tarihine kadar başlatılan işlemin bir kısmı veya tamamı için geri ödeme yapar. Başlıktaki requestId kombinasyonu ile paymentIntegratorAccountId, bu işlemi benzersiz şekilde tanımlayan kimlik anahtarıdır.

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadan yanıt gövdesi ErrorResponse türünde olmalıdır.

Örnek bir istek:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "liUrreQY233839dfFFb24gaQM",
    "requestTimestamp": "1502220434778"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "captureRequestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
  "currencyCode": "INR",
  "refundAmount": "208000000"
}

Örnek bir yanıt:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "result": "SUCCESS",
  "paymentIntegratorRefundId": "cmVmdW5kIGlkZW50aWZpZXINCg"
}

HTTP isteği

POST https://www.integratorhost.example.com/v1/refund

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "captureRequestId": string,
  "currencyCode": string,
  "refundAmount": string
}
Alanlar
requestHeader

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak üstbilgi.
paymentIntegratorAccountId

string

GEREKLİ: Bu işlemle ilgili sözleşme kısıtlamalarını tanımlayan ödeme entegratörü hesap kimliğidir.
captureRequestId

string

GEREKLİ: Bu işlem için benzersiz bir tanımlayıcıdır. Bu, Google'ın bu isteğin ilişkili olduğu capture araması sırasında oluşturulan requestId.
currencyCode

string

ZORUNLU: ISO 4217 3 harfli para birimi kodu
refundAmount

string (Int64Value format)

GEREKLİ: Geri ödemenin tutarı, para biriminin pozitif mikro sayısı.

Yanıt gövdesi

Geri ödeme yönteminin yanıt nesnesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorRefundId": string,
  "result": enum (RefundResultCode),
  "rawResult": {
    object (RawResult)
  }
}
Alanlar
responseHeader

object (ResponseHeader)

ZORUNLU: Tüm yanıtlar için ortak başlık.
paymentIntegratorRefundId

string

İSTEĞE BAĞLI: Bu tanımlayıcı, entegratöre özeldir ve entegratör tarafından oluşturulur. Bu, entegratörün bu geri ödemeyi bildiği tanımlayıcıdır.

Bu tanımlayıcı, size kolaylık sağlamak için havale ayrıntılarına dahil edilmiştir
result

enum (RefundResultCode)

GEREKLİ: Bu geri ödemenin sonucu.
rawResult

object (RawResult)

İSTEĞE BAĞLI: Bu geri ödemenin ham sonucu. Google'ın risk motorunu ve analizlerini bilgilendirmeye yardımcı olması için kullanılır. Reddetme kod eşleme durumlarında veriler bazen kaybolabilir. Entegratör, Google'a ham kod vermeyi tercih edebilir. Örneğin, kredi kartı ağ geçidi (entegratör), VISA ağından alınan tam reddetme kodunu Google'a bildirmek için bu alanı kullanabilir. Bu durumda, scope "vize", rawCode ise VISA ağının döndürdüğü değer olur.

result SUCCESS değilse bu değer gereklidir.

Geri ÖdemeSonuçKodu

Benzersiz sonuç, geri ödemeleri kodlar.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlama!
SUCCESS Başarılı geri ödeme.
NO_MONEY_LEFT_ON_TRANSACTION v1.refund başarısız oldu, işlemde para kalmadı. Bu, genellikle entegratör ve Google arasındaki hatayı temsil eder. Google, orijinal yakalamadan daha yüksek bir tutar için geri ödeme isteğinde bulunmamalıdır.
ACCOUNT_CLOSED

Entegratörle bekletilen hesap kapatıldı.

Bu değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışına tekrar giderek yeni bir araç eklemek zorunda kalacaktır.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

Kullanıcının entegratörle hesabı kapatıldı. Bu kullanıcının hesabın ele geçirildiğinden şüpheleniliyor.

Bu değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışına tekrar giderek yeni bir araç eklemek zorunda kalacaktır.
ACCOUNT_CLOSED_FRAUD

Kullanıcının entegratörle paylaştığı hesap, sahtekarlık nedeniyle kapatıldı.

Bu değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışına tekrar giderek yeni bir araç eklemek zorunda kalacaktır.
ACCOUNT_ON_HOLD Kullanıcının hesabı şu anda beklemededir ve geri ödemeyi kabul edemez. Ancak kullanıcının hesabı daha sonra geri ödemeyi kabul edebilir. Google gelecekte yeni bir geri ödeme isteğinde bulunabilir ancak yeni bir requestId isteği göndereceğinden bu istek tamamlanmış olarak kabul edilmelidir.
REFUND_EXCEEDS_MAXIMUM_BALANCE Kullanıcı bakiyesinin izin verilen maksimum tutarı aşmasına neden olacağından geri ödeme işlemi şu anda gerçekleştirilemiyor. Google gelecekte yeni bir geri ödeme isteğinde bulunabilir ancak yeni bir requestId isteği göndereceğinden bu istek tamamlanmış olarak kabul edilmelidir.
REFUND_WINDOW_EXCEEDED İstek, izin verilen geri ödeme süresinin dışında olduğundan geri ödeme işlenemiyor.