Skip to main content
Her kural bir oran, bir uygunluk penceresi ve isteğe bağlı satıcı filtreleri belirler ve tek bir alt hesapla sınırlandırılabilir. Nakit İade Kuralları API’sini platformunuzun finanse ettiği kuralları oluşturmak, güncellemek ve listelemek, ardından kullanılabilir USD bakiyenizden isteğe bağlı olarak nakit iade ödemesi yapmak için kullanın.

Uç noktalar

Nakit iadesi ödeme

Uygun tüm nakit iadelerini dağıtmak için POST /cashback_rules/payout adresine boş bir nesne gönderin. Tek bir kuralı dağıtmak için cashback_rule_id, tek bir alt hesaba ödeme yapmak için account_id veya tek bir kart işlemine ödeme yapmak için transaction_id ayarlayın. Birden fazla filtrenin tümü eşleşmelidir.
Ödeme talep ederken bir Idempotency-Key başlığı kullanın. status: "processing" içeren bir 202 yanıtı, işlemenin kuyruğa alındığını onaylar ve sağlanan filtreleri geri yansıtır. status: "failed" içeren bir 200 yanıtı, kuyruğun isteği reddettiği anlamına gelir. Bu durumlar ödemenin tamamlanmasını değil, zamanlamayı açıklar. İşlem görevleri hataları otomatik olarak yeniden dener. Fonlama cüzdanında yeterli bakiye yoksa cüzdana USD ekleyin. Tekrarlanan istekler zaten kaydedilmiş ödemeleri atlar ve defter idempotency’si yinelenen alacak kayıtlarını önler. Yanıt:

Öznitelikler

string
gerekli
cicbr_ önekli nakit iade kuralı kimliği.
string
gerekli
Kuralın oluşturulduğu zaman, ISO 8601 zaman damgası olarak.
string | null
gerekli
Nakit iade kuralının isteğe bağlı açıklaması.
string | null
gerekli
Kuralın kaldırıldığı zaman, ISO 8601 zaman damgası olarak. Null, kaldırılmadığı anlamına gelir.
string | null
gerekli
Uygunluk penceresinin hariç tutulan bitişi, ISO 8601 zaman damgası olarak. Null, sona erme olmadığı anlamına gelir.
string
gerekli
Nakit iadesini finanse etmek üzere belirlenen biz_ önekli platform hesabı. Kimliği doğrulanmış kimlik bilgisinden türetilir.
string | null
gerekli
Dört haneli satıcı kategori kodu. Null her MCC ile eşleşir. Her iki satıcı filtresi de null olduğunda scoped_account_id zorunludur.
string | null
gerekli
Kart sağlayıcısı tarafından bildirilen ham satıcı adı. Null her satıcı adıyla eşleşir. Ayarlandığında herhangi bir MCC filtresiyle birlikte eşleşir; alt dize veya zenginleştirilmiş görünen ad eşleşmesi değildir.
integer
gerekli
Baz puan cinsinden nakit iade oranı. 100, %1 ve 10000, %100 anlamına gelir.
string | null
gerekli
biz_ önekli alt hesap kimliği. Null, fonlayan platformun tüm doğrudan alt hesaplarını belirtir.
string
gerekli
Kuralın uygunluk penceresinin dahil edilen başlangıcı, ISO 8601 zaman damgası olarak.
string
gerekli
Kuralın son güncellendiği zaman, ISO 8601 zaman damgası olarak.
CashbackRule