PF Gateway API

PF Gateway ödeme sistemi API dokümantasyonu. Kart tokenizasyon, 3D Secure, ödeme, iade ve link ödeme işlemlerini entegre edin.

PF Gateway API, güvenli ödeme işlemlerini uygulamalarınıza entegre etmenizi sağlayan kapsamlı bir RESTful API'dir.

Temel Özellikler

Kart Tokenizasyon

Kart bilgilerini güvenli token'lara dönüştürün. PCI DSS uyumlu şekilde hassas kart verilerini saklayın.

3D Secure

3D Secure doğrulama ile güvenli ödeme akışı oluşturun.

Ödeme İşlemleri

Provision, PreAuth ve PostAuth ödeme tiplerini kullanarak ödeme alın.

Link ile Ödeme

Ödeme linkleri oluşturun ve müşterilerinize gönderin.

Hızlı Başlangıç

Entegrasyona başlamak için aşağıdaki adımları takip edin:

Test ve prod ortamına yurt dışı sunuculardan yapılan istekler engellenebilir. Sunucunuzun IP adresi yurt dışında ise IP sahiplik belgenizle birlikte entegrasyon@rubikpara.com adresine başvurmanız halinde ilgili IP adresinize erişim izni verilecektir.

API Anahtarlarını Alın — PublicKey ve SecretKey bilgilerinizi edinin.
İmza Oluşturun — Her istekte HMAC tabanlı Signature oluşturun. Kimlik Doğrulama Rehberi
Kart Tokenize Edin — Kart bilgilerini CardToken'a çevirin. Kart Token
3D Secure Başlatın — Gerekli durumlarda 3DS akışını başlatın. 3D Secure
Ödeme Alın — Provision isteği göndererek ödemeyi tamamlayın. Ödemeler

Base URL

Ortam	URL
Test	`https://testpfapi.rubikpara.com`
Prod	`https://prodpfapi.rubikpara.com`

Ortak Header'lar

Tüm API isteklerinde aşağıdaki header'lar gereklidir:

Header	Tip	Açıklama
`PublicKey`	string	Üye işyerine ait Public Key
`Nonce`	string	Her istek için benzersiz, tekrarlanmayan değer
`Signature`	string	HMAC ile oluşturulan imza
`ConversationId`	string	İstek takip numarası
`ClientIpAddress`	string	İşlem yapan kullanıcının IP adresi
`MerchantNumber`	string	Üye işyeri numarası

Test ortamı bilgileriniz için entegrasyon@rubikpara.com adresine başvurabilirsiniz.

Prod ortamı bilgilerinize https://prodmerchant.rubikpara.com adresinden giriş yaparak Bilgilerim sayfasından ulaşabilirsiniz.

Ortak Yanıt Yapısı

Tüm API yanıtları aşağıdaki ortak alanları içerir:

{
  "isSucceed": true,
  "errorCode": null,
  "errorMessage": null,
  "conversationId": "conv-123456"
}

Alan	Tip	Açıklama
`isSucceed`	boolean	İşlemin başarı durumu
`errorCode`	string	Hata kodu (başarılıysa `null`)
`errorMessage`	string	Hata mesajı (başarılıysa `null`)
`conversationId`	string	İstek takip numarası