Backend-to-Backend API
Status Lookup Deposit intent ve withdrawal kayıtları için support amaçlı status sorgusu.
Status endpoint'leri mevcut kaydın son durumunu okumak için kullanılır. Primary
state propagation mekanizması webhook'tur; bu endpoint'leri polling loop olarak
kullanmayın. En doğru kullanım support, reconciliation veya incident triage
akışıdır.
GET /api/v1/external/intents/:intentId curl " $PIENTEGRA_API_BASE /external/intents/01927b3c-9c1f-7a3a-9c4f-8a3e1f8b1c00" \ -H "Authorization: Bearer $PIENTEGRA_API_KEY " { "intentId" : "01927b3c-9c1f-7a3a-9c4f-8a3e1f8b1c00" , "referenceNo" : "D-2026-0000123" , "status" : "APPROVED" , "amount" : "100000" , "currency" : "TRY" , "approvedAt" : "2026-04-28T12:30:00.000Z" , "rejectedAt" : null , "rejectedReason" : null } Field Açıklama intentIdDeposit intent ID. referenceNoHuman-readable deposit reference. statusDeposit status. amountAmount string olarak döner. currencyISO 4217 currency code. approvedAtApprove timestamp veya null. rejectedAtReject timestamp veya null. rejectedReasonReject nedeni veya null.
Status Anlam RESERVEDIntent oluşturuldu, kullanıcıdan ödeme bekleniyor. PENDING_REVIEWPara geldi, Pientegra incelemeyi bekliyor. APPROVEDDeposit onaylandı. REJECTEDDeposit reddedildi. AUTO_CANCELLEDExpiry öncesi ödeme gelmedi. LATE_ARRIVALExpiry sonrası para geldi, manuel review gerekiyor.
GET /api/v1/external/withdrawals/:withdrawalId curl " $PIENTEGRA_API_BASE /external/withdrawals/01927b3c-9c1f-7a3a-9c4f-8a3e1f8b1c00" \ -H "Authorization: Bearer $PIENTEGRA_API_KEY " { "withdrawalId" : "01927b3c-9c1f-7a3a-9c4f-8a3e1f8b1c00" , "referenceNo" : "W-2026-0000123" , "status" : "SENT" , "amount" : "250000" , "currency" : "TRY" , "sentAt" : "2026-04-28T13:15:00.000Z" , "rejectedAt" : null , "rejectedReason" : null } Field Açıklama withdrawalIdWithdrawal ID. referenceNoHuman-readable withdrawal reference. statusWithdrawal status. amountAmount string olarak döner. currencyISO 4217 currency code. sentAtPara gönderim timestamp'i veya null. rejectedAtReject timestamp veya null. rejectedReasonReject nedeni veya null.
Status Anlam PENDING_REVIEWWithdrawal kaydı alındı, Pientegra incelemeyi bekliyor. APPROVEDPientegra onayladı, gönderim hazırlanıyor. SENTPara gönderildi. REJECTEDRequest reddedildi. RETURNEDBanka gönderimi iade etti.
API key bir site scope'una bağlıdır. Farklı site veya tenant'a ait ID'ler
okunamaz. Client tarafında bulunamayan kayıtları "not found or not in scope"
olarak ele alın.
HTTP errorAnlam 401 unauthorizedAPI key geçersiz. 404 not_foundResource yok veya bu API key'in scope'u dışında. 429 rate_limitedRate limit aşıldı.