Ana içeriğe geç

regular-payment

POST /api/{team}/gateway/regular-payment

Karttan 3D Secure adımı olmadan çekim yapar. Yanıt ödemenin sonucudur: result.successful: true ise tutar çekilmiştir. Akış: Regular Ödeme rehberi.

Kimlik doğrulama​

X-Api-Key, X-Timestamp, X-Signature, Content-Type: application/json. Ayrıntılar: Kimlik Doğrulama ve İmza. Uç, ödeme sınırına (dakikada 60) tabidir.

İstek​

Gövde secure-payment ile aynıdır; yalnızca transaction.callback_url yoktur (gönderilirse yok sayılır). Ödeme sonuçlanınca, panelde Ödeme Ayarları → Webhook sayfasında olaya tanımlı adreslere transaction.successful ya da transaction.failed webhook'u gönderilir.

{
"transaction": {
"reference": "SIP-10231",
"amount": "450.00",
"installment_number": 1,
"ip": "85.105.10.20"
},
"customer": {
"reference": "musteri-88",
"billing_address": {
"firstname": "Ahmet",
"lastname": "Yılmaz",
"email": "[email protected]",
"phone": "05551112233",
"address": "Kızılırmak Mah. Dumlupınar Blv. No:3",
"district": "Çankaya",
"province": "Ankara",
"country": "TR"
}
},
"card": {
"holder_name": "AHMET YILMAZ",
"number": "5400360000000003",
"security_code": "000",
"expiry_month": "12",
"expiry_year": "2030",
"should_save": true
}
}

Alan tabloları: transaction, customer, card.

SDK örnekleri​

not

Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak. $customer / customer nesnesi secure-payment örneğindeki gibidir.

use Gurmehub\Odemehub\Request\{Card, RegularPayment};

$payment = $client->regularPayment(new RegularPayment(
reference: 'SIP-10231',
amount: '450.00',
installmentNumber: 1,
ip: $_SERVER['REMOTE_ADDR'],
customer: $customer,
card: new Card(
holderName: 'AHMET YILMAZ',
number: '5400360000000003',
expiryMonth: '12',
expiryYear: '2030',
securityCode: '000',
shouldSave: true,
),
));

if ($payment->result->successful) {
$payment->transaction->token; // iade, iptal ve sorgu için saklayın
$payment->savedCard?->token; // kart saklandıysa
} else {
$payment->result->message;
}

Yanıt​

Ödeme başarılı:

{
"result": { "successful": true, "message": null },
"transaction": {
"token": "0b8f6c2d-3e41-4a7b-9c5d-1e2f3a4b5c6d",
"reference": "SIP-10231",
"status": "successful",
"payment_status": "paid",
"security_type": "regular",
"amount": "450.00",
"base_amount": "450.00",
"currency": "TRY",
"installment_number": 1,
"is_test": false,
"created_at": "2026-10-02T09:15:30.000000Z",
"order": null,
"payment_link": null,
"link_payment": null,
"subscription": null
},
"customer": {
"reference": "musteri-88",
"billing_address": { "firstname": "Ahmet", "lastname": "Yılmaz", "email": "[email protected]", "phone": "05551112233", "address": "Kızılırmak Mah. Dumlupınar Blv. No:3", "district": "Çankaya", "province": "Ankara", "country": "TR" }
},
"conversion": null,
"saved_card": {
"token": "2d4f6a8c-0e1b-4c3d-9f5e-7a9b1c3d5e6f",
"payment_provider_token": "8e0a2c4b-6d1f-4e3a-b5c7-9d1e3f5a7b2c",
"holder_name": "AHMET YILMAZ",
"scheme": "mastercard",
"first_digits": "54003600",
"last_four_digit": "0003",
"expiry_month": "12",
"expiry_year": "2030",
"is_default": true,
"created_at": "2026-10-02T09:15:31.000000Z"
}
}

Ödeme reddedildi (yine 200): result.successful false, result.message sağlayıcının mesajı; transaction.status failed. Sağlayıcıya ulaşılamadıysa result.message Ödeme sağlayıcısına ulaşılamadı. olur ve transaction.status timeout döner; bu durumda paranın çekilip çekilmediği sağlayıcıdan sorulmadan bilinmez.

Ödeme yanıtı​

secure-payment, regular-payment, refund-payment ve cancel-payment aynı biçimde yanıt verir. Ödemeleri sorgulamak için retrieve-payments kullanılır; onun listesindeki işlem nesnesi aynı alanları tek nesnede taşır.

AlanTipAçıklama
result.successfulbooleanÖdeme uçlarında ödemenin başarılı olup olmadığı; iade ve iptalde iade/iptal işleminin sonucu.
result.messagestring | nullsuccessful false ise nedeni; true ise null.
transaction.tokenstringÖdemenin token'ı.
transaction.referencestringÖdemenin reference değeri.
transaction.statusstringstarted, redirected_to_secure_page, returned_from_secure_page, timeout, failed, expired, successful. timeout: sağlayıcı yanıt vermedi, sonuç belirsiz.
transaction.payment_statusstringParanın durumu: unpaid, paid, cancelled, refunded, partially_refunded.
transaction.security_typestringsecure (3D) ya da regular.
transaction.amountstringÇekilen (çekilecek) tutar, iki ondalıklı.
transaction.base_amountstringSatılan tutar.
transaction.currencystringİstenen para birimi. Kur çevirisi uygulandıysa karttan çekilen para birimi conversion.currency'dedir.
transaction.installment_numberintegerTaksit sayısı.
transaction.is_testbooleanÖdeme test modunda alındıysa true.
transaction.created_atstringOluşturulma anı, ISO 8601 UTC.
transaction.orderobject | nullÖdeme bir siparişte alındıysa { "token": "…" }, değilse null.
transaction.payment_linkobject | nullÖdeme bir ödeme linkinde alındıysa { "token": "…" } (linkin token'ı), değilse null.
transaction.link_paymentobject | nullÖdeme bir ödeme linkinde alındıysa { "token": "…" } (link ödemesinin token'ı; retrieve-link-payments), değilse null. payment_link ile birlikte dolu gelir.
transaction.subscriptionobject | nullÖdeme bir aboneliğin dönemi içinse { "token": "…" }, değilse null. Bir webhook doğrulanırken ödemenin bildirimdeki kayda ait olduğu bu alanlarla kontrol edilir.
customer.referencestring | nullÖdemedeki müşteri referansı; gönderilmediyse null.
customer.billing_addressobjectÖdemedeki fatura adresinin dolu alanları (firstname … country, firma alanları dahil). Varsayılan Ödeyen'den doldurulan alanlar da burada döner.
conversionobject | nullÖdeme kur çevirisiyle başka para biriminde çekildiyse { "amount", "currency", "rate" } (string); değilse null. Bkz. Kur çevirisi.
saved_cardobject | nullYalnızca ödeme card.should_save: true ile başlatıldıysa bulunur. Ödeme başarılı ve kart saklandıysa kart nesnesi, değilse null.

HTTP durum kodları​

KodDurum
200Ödeme işlendi; sonuç result.successful içinde.
401API anahtarı ya da imza geçersiz.
403Çalışma alanı işlem yapamıyor ya da Api modülü kapalı.
422Doğrulama hatası.
429İstek sınırı aşıldı.

Hatalar​

secure-payment ile aynıdır; ödeme hesabı mesajı Bu ödeme hesabı Güvenlik Doğrulamasız ödeme desteklemiyor. olarak döner.