Download the PHP package eren-seyfi/php-iyzico without Composer

On this page you can find all versions of the php package eren-seyfi/php-iyzico. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of eren-seyfi/php-iyzico

Informations about the package php-iyzico

Eren/PhpIyzico – Integration Helpers for iyzico (iyzipay-php)

Resmi [iyzico/iyzipay-php] SDK’sı etrafında hafif service ve security yardımcıları.
Tekrarlayan kodu azaltır; Non-3D/3DS ödeme, Checkout Form, Kart Saklama, Abonelik (Subscription), İade/İptal, Durum Sorgu ve İmza Doğrulama akışlarını tek API ile düzenler.

PHP: 7.4+
SDK: iyzico/iyzipay-php (Composer)
TLS: en az TLS 1.2

İçindekiler

Kurulum

Projene helper’ları dahil et:

Hızlı Başlangıç

Mimari ve Sınıflar

Sınıf Amaç Not
Config API anahtarı, secret, baseUrl, locale, conversationId Tüm servislere tek noktadan geçer
OptionsFactory Iyzipay\Options üretimi SDK aramaları için
Iyzico Facade: servisleri bir araya getirir $iyz->non3ds(), $iyz->subscriptions()
Security\Signature HMAC-SHA256 imza hesaplama/doğrulama Callback/Webhook/Payment doğrulama
Support\Helpers Buyer/Address/BasketItem kurulum yardımcıları Veri normalizasyonu
Services\Payments\Non3DS Non-3D ödeme akışı pay(), payAndVerify(), retrieve()
Services\Payments\ThreeDS 3DS akışı init(), auth(), ...AndVerify()
Services\Checkout\CheckoutFormService Hosted Checkout Form initialize(), retrieve(), verify
Services\CardStorage Kart saklama create/list/delete
Services\RefundCancel İade / İptal cancel/refund
Services\Status Ödeme durumu paymentDetail
Services\BinService BIN sorgu banka/marka/taksit
Services\Subscription\* Abonelik modülü Ürün/Plan/Müşteri/Abonelik/Webhook

Güvenlik & İmza Doğrulama

Security\Signature HMAC-SHA256 + Base64 (ikili çıktı) hesaplar. Dokümana göre tipik sıralar:

Varsayılan ayraç : kabul edilmiştir. Sende farklıysa helper’da değiştir.

Örnek:

Ödeme Akışları

Non-3D Ödeme

Servis: Services\Payments\Non3DS

Metotlar

Metot Geri Dönüş Açıklama
pay($order,$card,$buyer,$ship,$bill,$items) Iyzipay\Model\Payment Tek adımda ödeme
payAndVerify(...) ['payment'=>Payment,'verified'=>bool,'calculated'=>string] Ödeme + imza doğrulama
retrieve($query) Payment paymentId / paymentConversationId ile sorgu
retrieveAndVerify($query) aynı Sorgu + imza doğrulama

$order Parametreleri

Parametre Zorunlu Tip Açıklama
price ✔ numeric-string Ürün toplam tutarı
paidPrice ✖ numeric-string Komisyon/vergiler dahil (≥ price)
currency ✖ string (SDK sabiti) Varsayılan Currency::TL
installment ✖ int Varsayılan 1
basketId ✖ string Sipariş no
paymentChannel ✖ string (sabit) PaymentChannel::WEB (default)
paymentGroup ✖ string (sabit) PaymentGroup::PRODUCT (default)
locale / conversationId ✖ string Aksi halde Config’ten alınır

Örnek

3DS Ödeme

Servis: Services\Payments\ThreeDS

Metotlar

Metot Geri Dönüş Açıklama
init($order,$card,$buyer,$ship,$bill,$items,$callbackUrl) ThreedsInitialize 3DS başlat
initAndVerify(...) ['init'=>ThreedsInitialize,'verified'=>bool,'calculated'=>string] Initialize + imza
auth($paymentId,$conversationData) ThreedsPayment 3DS tamamlama
authAndVerify($paymentId,$conversationData) ['payment'=>ThreedsPayment,'verified'=>bool,'calculated'=>string] Tamamlama + imza

callbackUrl zorunlu (init). paidPrice ≥ price kuralını koruyun.

Checkout Form

Servis: Services\Checkout\CheckoutFormService

Metotlar

Metot Geri Dönüş Açıklama
initialize($order,$buyer,$ship,$bill,$items,$callback) CheckoutFormInitialize Standart CF
initializePreAuth(...) CheckoutFormInitializePreAuth Ön provizyon CF
initializeAndVerify(..., $preAuth=false) ['init'=>..., 'verified'=>bool, 'calculated'=>string] Init + imza
verifyInitializeSignature($init) bool conversationId:token sırasıyla
retrieve($token) CheckoutForm CF sonucunu çek
retrieveAndVerify($token) ['form'=>CheckoutForm,'verified'=>bool,'calculated'=>string] CF sonucu + imza

$order Parametreleri

Parametre Zorunlu Tip Açıklama
price ✔ numeric-string Temel tutar
paidPrice ✖ numeric-string (≥ price)
currency ✖ string (sabit) Varsayılan Currency::TL
basketId ✖ string Sipariş no
paymentGroup ✖ string (sabit) Varsayılan PaymentGroup::PRODUCT
enabledInstallments ✖ int[] [2,3,6,9] gibi
cardUserKey ✖ string Kayıtlı kartları göstermek için
locale / conversationId ✖ string Aksi halde Config

Örnek

Kart Saklama (Card Storage)

Servis: Services\CardStorage

Metot Geri Dönüş Açıklama
createUserAndAddCard($email,$externalId,$cardInfo) Card Yeni user + kart ekle
addCard($cardUserKey,$cardInfo) Card Var kullanıcıya kart ekle
list($cardUserKey) CardList Kayıtlı kartlar
delete($cardUserKey,$cardToken) Card Kart sil

$cardInfo (CardInformation)

Alan Zorunlu Tip Örnek
number ✔ string 5528790000000008
expireMonth ✔ string "12"
expireYear ✔ string "2030"
holderName ✔ string "John Doe"
cardAlias ✖ string "Main Card"

CVC yoktur (PCI-DSS).

İade / İptal

Servis: Services\RefundCancel

Metot Zorunlu Alanlar Açıklama
cancel($paymentId, ?$ip, ?$reason, ?$desc) paymentId Tam iptal
refund($paymentTransactionId, $price, $currency='TL', ?$ip, ?$reason, ?$desc) paymentTransactionId, price Kısmi/Tam iade

Durum Sorgu

Servis: Services\Status

Metot Parametreler Açıklama
paymentDetail(?$paymentId=null, ?$paymentConversationId=null) En az birisi Payment detayını döndürür

BIN Sorgu

Servis: Services\BinService

Metot Parametre Açıklama
lookup(string $bin) İlk 6 hane Banka/marka/taksit bilgisi

Abonelik (Subscription)

Ürün CRUD (SubscriptionProduct)

Servis: Subscription\ProductService

Metot Parametreler Açıklama
create($name, ?$description) name ✔ Ürün oluştur
retrieve($productRefCode) productRefCode ✔ Ürün detay
list($page=1,$count=20) ✖ Ürün liste (sayfalı)
update($productRefCode, ?$name, ?$description) productRefCode ✔ Ürün güncelle
delete($productRefCode) productRefCode ✔ Ürün sil

Plan CRUD (PricingPlan)

Servis: Subscription\PricingPlanService

Metot Parametreler Açıklama
create($data) Aşağıdaki tablo Plan oluştur
retrieve($planRef) planRef ✔ Plan detay
list($productRef,$page=1,$count=20) productRef ✔ Ürüne bağlı planları listele
update($planRef,$data) planRef ✔ Plan güncelle
delete($planRef) planRef ✔ Plan sil

$data (create/update) – Önemli Alanlar

Alan Zorunlu Tip Not
name ✔ string Plan adı
productReferenceCode ✔ (create) string Ürün ref
price ✔ numeric-string
currencyCode ✔ string TRY, USD, …
paymentInterval ✔ string DAY | WEEK | MONTH | YEAR
paymentIntervalCount ✔ int
trialPeriodDays ✖ int
planPaymentType ✖ RECURRING | PREPAID
recurrenceCount ✖ int|null Süreli planlar için

Müşteri CRUD (Subscription Customer)

Servis: Subscription\CustomerService

Metot Parametreler Açıklama
create($data) Aşağıdaki tablo Müşteri oluştur
retrieve($customerRef) customerRef ✔ Müşteri detay
list($page=1,$count=20) ✖ Müşteri liste
update($customerRef,$data) customerRef ✔ Müşteri güncelle
delete($customerRef) customerRef ✔ Müşteri sil

$data (create/update) – Alanlar

Alan Zorunlu Tip Not
name, surname, email ✔ string Temel bilgiler
gsmNumber, identityNumber ✖ string
shippingContactName/city/district/country/address/zipCode ✖ string
billingContactName/city/district/country/address/zipCode ✖ string

Abonelik İşlemleri (SubscriptionService)

Servis: Subscription\SubscriptionService

Metot Parametreler Açıklama
createCheckoutForm($data,$customerData) pricingPlanReferenceCode ✔, subscriptionInitialStatus?, callbackUrl? CF ile abonelik başlat
retrieveCheckoutFormResult($checkoutFormToken) token ✔ CF sonucunu çek
createNon3D($data,$paymentCardData,$customerData) plan + kart + müşteri API ile abonelik başlat (non3D)
createWithCustomer($data) pricingPlanReferenceCode ✔, customerReferenceCode ✔ Mevcut müşteri ile başlat
activate($subscriptionRef) ✔ Aboneliği aktifleştir
retry($referenceCode) ✔ Başarısız ödemeyi tekrar dene
upgrade($data) subscriptionReferenceCode ✔, newPricingPlanReferenceCode ✔, upgradePeriod ✔ Yükseltme
cancel($subscriptionRef) ✔ İptal
details($subscriptionRef) ✔ Detay
search($filters) sayfalama + durum + tarih Liste/arama
cardUpdateCheckout($data) customerReferenceCode ✔, callbackUrl ✔ Kart güncelleme checkout’u

Upgrade $data Alanları

Alan Zorunlu Tip Not
subscriptionReferenceCode ✔ string
newPricingPlanReferenceCode ✔ string
upgradePeriod ✔ NOW | NEXT_PERIOD
useTrial ✖ bool
resetRecurrenceCount ✖ bool

Kart Güncelleme (Hosted Form)

Servis: Subscription\CardUpdateService

Metot Parametreler Açıklama
create($customerRefCode,$callbackUrl) ✔ Kart güncelleme formu

Webhook Doğrulama (Subscription)

Servis: Subscription\Webhook

Metot Parametreler Açıklama
verifyV3($payload,$headers) X-Iyz-Signature-V3 Abonelik event’leri için imza doğrulama

Alanlar & Zorunluluk Tabloları

Buyer

Alan Zorunlu Tip
id, name, surname, email ✔ string
gsmNumber, identityNumber ✖ string
registrationAddress, city, country, zipCode ✔ string
ip ✔ string (IPv4/IPv6)
lastLoginDate, registrationDate ✖ Y-m-d H:i:s

Address

Alan Zorunlu Tip
contactName ✔ string
city, country, address, zipCode ✔ string
district ✖ string

BasketItem

Alan Zorunlu Tip Not
id, name, category1 ✔ string
category2 ✖ string
itemType ✔ sabit BasketItemType::PHYSICAL | VIRTUAL
price ✔ numeric-string

Klasör Yapısı

Sandbox & Test Kartları

Güvenlik Önerileri

Değişiklikler

Lisans

Bu yardımcılar projenize göre uyarlanabilir. Resmi iyzico/iyzipay-php SDK lisansı kendi deposunda geçerlidir.

All versions of php-iyzico with dependencies

PHP Build Version
Package Version
Requires php Version >=8.1
iyzico/iyzipay-php Version ^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package eren-seyfi/php-iyzico contains the following files

Loading the files please wait ...