> For the complete documentation index, see [llms.txt](https://developer.ahlpay.com.tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.ahlpay.com.tr/ahl-pay-entegrasyonu.md).

# AHL Pay Entegrasyonu

## Sanal Pos Entegrasyonu

Entegrasyona başlarken test ortamında üye işyeri ve API kullanıcı tanımlarınız operasyon ekiplerimiz yapıldıktan hemen sonra entegrasyon için gerekli bilgiler (e-mail, password, kayıtlı olan SMS ya da e-posta adresine otomatik olarak iletilecektir.

**Entegrasyon metoduna karar vermek**

**Ortak Ödeme Formu:** İşyerinizin amacı hızlı ve kolay bir şekilde ödeme almaya başlamak ise AHL Pay ödeme ekranını tercih edebilirsiniz. Ön yüz kontrolleri, BIN sorgulama, Taksit Sorgulama, 3D Secure ile ödeme entegrasyonları için ek sorgu yapmaya gerek kalmadan tek bir entegrasyon ile işlemler tamamlanır. İşyeri bazında 3D Secure zorunluluğu, NonSecure maksimum işlem tutarı ya da farklı para birimlerinin desteklenme kontrolleri backoffice ekranları üzerinden kolayca düzenlenebilir.

**API:** Üye işyeri kendi ödeme formunu kullanır. Bu entegrasyonda API Gateway servisleri üye işyeri ödeme formunun arkasında çalışır. İstenilen servisler iş modelinin ihtiyacına göre entegre edilebilir. API kısmında servisler detaylandırılmıştır.

**Dikkat edilmesi gereken kısımlar**

3D Ödeme işlemleri asenkron gerçekleşmektedir. İşlem sonucu parametrede belirttiğiniz url adreslerine yönlendirilecektir. İşlem başarılı olması durumunda okUrl, başarısız olması durumunda failUrl sayfasına yönlenecektir. Ek olarak servislerin data kısmında dönen html bilgileri de kontrol edilmesi gerekmektedir.\
\
Regülasyon gereği canlı ortama geçiş öncesinde üye işyerinin statik IP adresi ve callback URL bilgileri **<posdestek@ahlpay.com.tr>** mail adresi üzerinden tarafımıza bildirilmeli ve tarafımızca tanımlanmalıdır. Tanımlanan callback URL ve statik IP adresleri dışında başka bir parametre ile tarafımıza gelinmesi durumunda işlem kısıtlamaya girip, gerçekleştirilmeyecektir.

İptal işlemini yapmak için **VOID** servisini kullanabilirsiniz; İade için **Refund** servisini kullanılması gerekmektedir. Provizyon tarihi aynı gün ise "Void" (iptal), provizyon tarihi geçmiş bir tarih ise "Refund" (iade) gönderilmelidir.

İşlemin durumunu öğrenmek için Ödeme Sorgulama (PaymentInquiry) servisini kullanabilirsiniz.

<https://www.ahlpay.com.tr/basvuru> adresi üzerinden AHL Pay Sanal Pos başvurusu gerçekleştirebilirsiniz.