Sorgulama API

Bu sayfada, işlem durumu ve detaylarının sorgulanmasına yönelik Sorgulama API yapısı ve kullanım adımları açıklanmaktadır.

İşlem Durumu Sorgulama

Üye işyeri, yaptığı işlemlerin en güncel durumunu takip etmek için VPOS tarafından sağlanan sorgulama servislerini kullanabilir.

Amaç

İşlem tamamlandıktan sonra aşağıdaki adımların güncel durumunu almak için kullanılır:

• Sipariş durumu

• Onay (approval)

• İade (refund)

• Provizyon (authorization)

• 3DS doğrulama (authentication)

Bu sorgulamalar sayesinde üye işyeri, işlem akışını izleyebilir ve sistemsel aksiyonlarını doğru şekilde planlayabilir.

Sorgulama Servisleri

VPOS sistemi aşağıdaki sorgulama servislerini sunar:

Servis Adı	Açıklama
Token ile Sorgulama (byToken)	İşlem token’ı ile sorgulama yapılır. Genellikle 3DS doğrulama sonrası kullanılır.
İşlem ID ile Sorgulama (byProcessId)	VPOS işlem ID’si ile sorgulama yapılır. Sistemsel takip için uygundur.
Sipariş Numarası ile Sorgulama (byOrderId)	Sipariş numarası ile sorgulama yapılır. Üye işyeri sistemine entegre kullanım için idealdir.
Sipariş Numarası ile İşlem Geçmişi Sorgulama (listByOrderId)	Belirli bir siparişe ait tüm işlemleri listeler (örneğin: satış + iade).

İpucu

Her sorgulama servisi farklı senaryolarda kullanılmak üzere tasarlanmıştır. Örneğin, byToken servisi genellikle 3DS doğrulama sonrası işlem tamamlanmadan önce kullanılırken, listByOrderId servisi bir siparişin tüm işlem geçmişini görmek için idealdir.