Genel Bakış ve Token
ÖdeLink ile müşterinize kart bilgisini gireceği bir ödeme sayfası linki gönderirsiniz. Kart bilgisi sizin sisteminize hiç gelmez.
Merchant Portal'daki Link ile Ödeme → ÖdeLink Oluştur ekranında yapılan her işlem bu dokümandaki API çağrılarıyla da yapılabilir. Portal da arka planda aynı uçları kullanır.
Akış
- API anahtarınızla token alırsınız.
- Link oluşturursunuz. Fiziksel ve Dijital linklerde önce ürün kaydı oluşturulur.
- Cevaptaki
storefront_urladresini müşterinize iletirsiniz (SMS, e-posta, WhatsApp, QR). - Müşteri ödeme sayfasında bilgilerini ve kartını girer, taksit seçer, 3D Secure ile öder.
- Ödeme sonucu webhook ile sisteminize bildirilir.
Genel Kurallar
| Konu | Kural |
|---|---|
| Biçim | İstek ve cevap gövdeleri JSON, alan adları snake_case |
| Tutarlar | Kuruş cinsinden tam sayı. 150,00 TL → 15000 |
| Para birimi | TRY |
| Kimlik | Her istekte Authorization: Bearer <access_token> |
| Üye işyeri | X-External-Merchant-Id: <üye işyeri numarası>. Gönderilmezse anahtarın bağlı olduğu üye işyeri kullanılır; gönderilirse anahtarın üye işyeriyle aynı olmalıdır |
| Zaman | ISO 8601, saat dilimiyle (2026-12-31T23:59:59+03:00) |
| Tekrar deneme | Link ve ürün oluşturma isteklerine Idempotency-Key: <tekil değer> başlığı ekleyin. Cevap alamayıp aynı isteği aynı anahtarla tekrar gönderdiğinizde yeni kayıt açılmaz, ilk kayıt döner. Her yeni kayıt için yeni bir anahtar üretin |
| Hata | application/problem+json; koşullarınızı code alanına göre yazın (bkz. Hata Kodları) |
Örnek Değişkenler
Dokümandaki örnekler aşağıdaki değişkenleri kullanır. Adresler için: Test ve Canlı Ortamları
export ID_URL="https://vpos-id.stg.odeal.com"
export API_URL="https://vpos-api.stg.odeal.com"
export TENANT="odeal"
export CLIENT_ID="<client-id>"
export CLIENT_SECRET="<client-secret>"
export MERCHANT_NO="<uye-isyeri-no>"Token Alma
curl -X POST "$ID_URL/api/v1/auth/$TENANT/token" \
-H "Content-Type: application/json" \
-d '{
"client_id": "'"$CLIENT_ID"'",
"client_secret": "'"$CLIENT_SECRET"'"
}'Cevap (200 OK, kısaltılmış):
{
"token": {
"access_token": "eyJhbGciOi...",
"expires_in": 300,
"token_type": "Bearer"
},
"challenge": null
}Token 300 saniye geçerlidir. Saklayıp süresi dolana kadar tüm isteklerde kullanın, süresi dolmadan aynı istekle yenisini alın. Cevaptaki diğer alanları kullanmanız gerekmez.
Her istekte yeni token almayın
Token ucu istek sayısıyla sınırlıdır; sınır aşılırsa 429 rate_limit_exceeded döner.
export TOKEN="<access_token>"Destek
Entegrasyonla ilgili sorularınız için: [email protected]

