Skip to main content
Payven, tüm tarih-zaman alanlarında ISO-8601 formatını ve UTC zaman dilimini kullanır.

Format

2026-05-03T12:34:56.789+00:00
Yanıtlardaki tarih alanları her zaman explicit offset (+HH:mm) ile döner — UTC için +00:00. İstek tarafında hem Z hem +00:00 kabul edilir; ikisi aynı anlamdadır.
BölümAnlam
2026-05-03Tarih (yıl-ay-gün)
TTarih ve saat ayırıcısı
12:34:56.789Saat:dakika:saniye.milisaniye
+00:00UTC offset (gönderirken Z de kabul edilir)

Yerel saat gönderme

Yerel saat dilimi göndermek istiyorsanız offset ekleyin. Türkiye için +03:00:
2026-05-03T15:34:56+03:00
Bu değer Payven tarafında otomatik olarak UTC’ye çevrilip saklanır.

Yanıtlarda

Tüm yanıtlardaki tarih alanları UTC olarak döner:
{
  "id":         "8e3f5c12-...",
  "created_at": "2026-05-03T12:34:56.789+00:00",
  "updated_at": "2026-05-03T12:35:01.234+00:00"
}

Yerel saatte gösterme

Müşteriye gösterirken kendi tarafınızda yerelleştirin:
var utc = DateTimeOffset.Parse("2026-05-03T12:34:56.789Z");
var istanbul = TimeZoneInfo.FindSystemTimeZoneById("Turkey Standard Time");
var local = TimeZoneInfo.ConvertTime(utc, istanbul);

Console.WriteLine(local.ToString("dd MMMM yyyy HH:mm", new CultureInfo("tr-TR")));
// 03 Mayıs 2026 15:34

Tarih aralığı parametreleri

Liste sorgularında tarih aralığı parametreleri yine ISO-8601 + UTC beklenir:
GET /api/v1/transactions?from=2026-05-01T00:00:00Z&to=2026-05-31T23:59:59Z
ParametreYönTip
fromdahilUTC tarih-zaman
todahilUTC tarih-zaman
Yerel saat dilimini sorguya çevirmeyi unutmayın — örn. “1 Mayıs 2026 Türkiye saati ile 00:00” → 2026-04-30T21:00:00Z.
Mutabakat ve raporlama için gün başı/sonu sınırlarını organizasyonunuzun tercih ettiği zaman dilimine göre konsoldan ayarlayabilirsiniz. Detay: Mutabakat → Yaşam Döngüsü.