Method: refund

capture aracılığıyla başlatılan işlemin bir kısmı veya tamamı geri ödeme alır. Başlık içindeki requestId ve paymentIntegratorAccountId kombinasyonu, bu işlemi benzersiz şekilde tanımlayan idempotence anahtarıdır.

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

Örnek 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 aşağıdaki gibidir:


{
  "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 verileri 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 başlık.
paymentIntegratorAccountId

string

ZORUNLU: Bu işlemle ilgili sözleşmeden doğan kısıtlamaları tanımlayan ödeme entegratörü hesap kimliğidir.
captureRequestId

string

ZORUNLU: Bu işlem için benzersiz bir tanımlayıcı. Bu, isteğin ilişkili olduğu capture çağrısı sırasında Google tarafından oluşturulan requestId öğesidir.
currencyCode

string

ZORUNLU: ISO 4217 3 harfli para birimi kodu
refundAmount

string (Int64Value format)

ZORUNLU: Geri ödeme tutarı, para biriminin pozitif mikro sayısıdır.

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, entegrasyon uzmanının bu geri ödemeyi bildiği tanımlayıcıdır.

Kolaylık sağlaması açısından bu tanımlayıcı, havale ayrıntılarında belirtilmiştir
result

enum (RefundResultCode)

ZORUNLU: Bu geri ödemenin sonucu.
rawResult

object (RawResult)

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

result, SUCCESS değilse bu değer zorunludur.

RefundResultCode

Benzersiz sonuç kodları geri ödemeler.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri asla ayarlamayın.
SUCCESS Geri ödeme başarılı.
NO_MONEY_LEFT_ON_TRANSACTION v1.refund başarısız oldu, işlemde para kalmamış. Bu genellikle entegrasyon uzmanı ile Google arasındaki hatayı temsil eder. Google, orijinal yakalamadan daha yüksek bir tutarın geri ödenmesini istememelidir.
ACCOUNT_CLOSED

İntegratörde bulunan 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ışından tekrar geçerek yeni bir araç eklemeye zorlanır.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

Kullanıcının entegrasyon uzmanındaki hesabı kapatıldı ve şüpheli hesap devralındı.

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ışından tekrar geçerek yeni bir araç eklemeye zorlanır.
ACCOUNT_CLOSED_FRAUD

Kullanıcının entegrasyon uzmanındaki hesabı 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ışından tekrar geçerek yeni bir araç eklemeye zorlanır.
ACCOUNT_ON_HOLD Kullanıcının hesabı şu anda beklemede ve geri ödemeyi kabul edemez, ancak kullanıcının hesabı daha sonra geri ödemeyi kabul edebilir. Google gelecekte başka bir geri ödeme isteğinde bulunabilir ancak yeni bir requestId ile bunu talep eder. Bu nedenle, bu istek tamamlanmış sayılır.
REFUND_EXCEEDS_MAXIMUM_BALANCE Geri ödeme, kullanıcının bakiyesinin izin verilen maksimum tutarı aşmasına neden olacağından şu anda işleme alınamıyor. Google gelecekte başka bir geri ödeme isteğinde bulunabilir ancak yeni bir requestId ile bunu talep eder. Bu nedenle, bu istek tamamlanmış sayılır.
REFUND_WINDOW_EXCEEDED İstek, izin verilen geri ödeme süresinin dışında olduğu için geri ödeme işlenemiyor.