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",
"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
Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak. $customer / customer nesnesi secure-payment örneğindeki gibidir.
- PHP
- Node.js
- Python
- Java
- cURL
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;
}
const payment = await client.regularPayment({
reference: 'SIP-10231',
amount: '450.00',
installmentNumber: 1,
ip: req.ip,
customer,
card: {
holderName: 'AHMET YILMAZ',
number: '5400360000000003',
securityCode: '000',
expiryMonth: '12',
expiryYear: '2030',
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;
}
from odemehub.request import Card, RegularPayment
payment = client.regular_payment(RegularPayment(
reference="SIP-10231",
amount="450.00",
installment_number=1,
ip=request.remote_addr,
customer=customer,
card=Card(
holder_name="AHMET YILMAZ",
number="5400360000000003",
expiry_month="12",
expiry_year="2030",
security_code="000",
should_save=True,
),
))
if payment.result.successful:
payment.transaction.token # iade, iptal ve sorgu için saklayın
payment.saved_card # kart saklandıysa
else:
payment.result.message
import com.odemehub.request.Card;
import com.odemehub.request.RegularPayment;
var payment = client.regularPayment(RegularPayment.builder()
.reference("SIP-10231")
.amount("450.00")
.installmentNumber(1)
.ip(request.getRemoteAddr())
.customer(customer)
.card(Card.builder()
.holderName("AHMET YILMAZ")
.number("5400360000000003")
.securityCode("000")
.expiryMonth("12")
.expiryYear("2030")
.shouldSave(true)
.build())
.build());
if (payment.getResult().isSuccessful()) {
payment.getTransaction().getToken(); // iade, iptal ve sorgu için saklayın
payment.getSavedCard(); // kart saklandıysa
} else {
payment.getResult().getMessage();
}
URI_PATH="/api/$ODEMEHUB_TEAM/gateway/regular-payment"
BODY='{"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}}'
TIMESTAMP=$(date +%s)
SIGNATURE=$(printf '%s\n%s\n%s\n%s' "$TIMESTAMP" "POST" "$URI_PATH" "$BODY" | openssl dgst -sha256 -hmac "$ODEMEHUB_API_SECRET" | sed 's/^.* //')
curl -X POST "https://sandbox.odemehub.com$URI_PATH" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $ODEMEHUB_API_KEY" \
-H "X-Timestamp: $TIMESTAMP" \
-H "X-Signature: $SIGNATURE" \
--data-raw "$BODY"
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.
| Alan | Tip | Açıklama |
|---|---|---|
result.successful | boolean | Ödeme uçlarında ödemenin başarılı olup olmadığı; iade ve iptalde iade/iptal işleminin sonucu. |
result.message | string | null | successful false ise nedeni; true ise null. |
transaction.token | string | Ödemenin token'ı. |
transaction.reference | string | Ödemenin reference değeri. |
transaction.status | string | started, redirected_to_secure_page, returned_from_secure_page, timeout, failed, expired, successful. timeout: sağlayıcı yanıt vermedi, sonuç belirsiz. |
transaction.payment_status | string | Paranın durumu: unpaid, paid, cancelled, refunded, partially_refunded. |
transaction.security_type | string | secure (3D) ya da regular. |
transaction.amount | string | Çekilen (çekilecek) tutar, iki ondalıklı. |
transaction.base_amount | string | Satılan tutar. |
transaction.currency | string | İstenen para birimi. Kur çevirisi uygulandıysa karttan çekilen para birimi conversion.currency'dedir. |
transaction.installment_number | integer | Taksit sayısı. |
transaction.is_test | boolean | Ödeme test modunda alındıysa true. |
transaction.created_at | string | Oluşturulma anı, ISO 8601 UTC. |
transaction.order | object | null | Ödeme bir siparişte alındıysa { "token": "…" }, değilse null. |
transaction.payment_link | object | null | Ödeme bir ödeme linkinde alındıysa { "token": "…" } (linkin token'ı), değilse null. |
transaction.link_payment | object | 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.subscription | object | 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.reference | string | null | Ödemedeki müşteri referansı; gönderilmediyse null. |
customer.billing_address | object | Ödemedeki fatura adresinin dolu alanları (firstname … country, firma alanları dahil). Varsayılan Ödeyen'den doldurulan alanlar da burada döner. |
conversion | object | null | Ödeme kur çevirisiyle başka para biriminde çekildiyse { "amount", "currency", "rate" } (string); değilse null. Bkz. Kur çevirisi. |
saved_card | object | null | Yalnı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ı
| Kod | Durum |
|---|---|
200 | Ödeme işlendi; sonuç result.successful içinde. |
401 | API anahtarı ya da imza geçersiz. |
403 | Çalışma alanı işlem yapamıyor ya da Api modülü kapalı. |
422 | Doğ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.