curl --request POST \
--url https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"card": {
"holder_name": "<string>",
"number": "<string>",
"expire_month": "<string>",
"expire_year": "<string>",
"cvv": "<string>"
},
"extra_properties": {}
}
'import requests
url = "https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry"
payload = {
"transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"card": {
"holder_name": "<string>",
"number": "<string>",
"expire_month": "<string>",
"expire_year": "<string>",
"cvv": "<string>"
},
"extra_properties": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
transaction_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
card: {
holder_name: '<string>',
number: '<string>',
expire_month: '<string>',
expire_year: '<string>',
cvv: '<string>'
},
extra_properties: {}
})
};
fetch('https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'transaction_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'card' => [
'holder_name' => '<string>',
'number' => '<string>',
'expire_month' => '<string>',
'expire_year' => '<string>',
'cvv' => '<string>'
],
'extra_properties' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry"
payload := strings.NewReader("{\n \"transaction_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"card\": {\n \"holder_name\": \"<string>\",\n \"number\": \"<string>\",\n \"expire_month\": \"<string>\",\n \"expire_year\": \"<string>\",\n \"cvv\": \"<string>\"\n },\n \"extra_properties\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"transaction_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"card\": {\n \"holder_name\": \"<string>\",\n \"number\": \"<string>\",\n \"expire_month\": \"<string>\",\n \"expire_year\": \"<string>\",\n \"cvv\": \"<string>\"\n },\n \"extra_properties\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transaction_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"card\": {\n \"holder_name\": \"<string>\",\n \"number\": \"<string>\",\n \"expire_month\": \"<string>\",\n \"expire_year\": \"<string>\",\n \"cvv\": \"<string>\"\n },\n \"extra_properties\": {}\n}"
response = http.request(request)
puts response.read_body{
"transaction_id": "8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6",
"status": "completed",
"is_success": true,
"message": "İşlem başarıyla tamamlandı",
"error_code": "bank_declined",
"provider_error_code": "51",
"extra_properties": {}
}{
"type": "https://docs.payven.com.tr/errors/bad_request",
"title": "Geçersiz istek",
"status": 400,
"code": "bad_request",
"detail": "amount.amount alanı zorunlu.",
"correlation_id": "9f1c8e76-2a3b-4f12-9c8d-12cb24a8a8a8"
}{
"type": "https://docs.payven.com.tr/errors/invalid_token",
"title": "Geçersiz token",
"status": 401,
"code": "invalid_token",
"detail": "Access token geçersiz veya süresi dolmuş — refresh edin."
}{
"type": "https://docs.payven.com.tr/errors/forbidden",
"title": "Yetki yok",
"status": 403,
"code": "forbidden",
"detail": "Bu rol bu kaynağı göremez."
}{
"type": "https://docs.payven.com.tr/errors/resource_not_found",
"title": "Kaynak bulunamadı",
"status": 404,
"code": "resource_not_found"
}{
"type": "https://docs.payven.com.tr/errors/idempotency_key_in_use",
"title": "Idempotency-Key çakışması",
"status": 409,
"code": "idempotency_key_in_use",
"detail": "Bu Idempotency-Key daha önce farklı bir istek gövdesi ile kullanıldı."
}{
"type": "https://docs.payven.com.tr/errors/bank_declined",
"title": "Banka işlemi reddetti",
"status": 422,
"code": "bank_declined",
"detail": "Yetersiz bakiye (banka kodu: 51)",
"provider_error_code": "51"
}{
"type": "https://docs.payven.com.tr/errors/rate_limit_exceeded",
"title": "İstek limiti aşıldı",
"status": 429,
"code": "rate_limit_exceeded"
}{
"type": "https://docs.payven.com.tr/errors/internal_server_error",
"title": "Sunucu hatası",
"status": 500,
"code": "internal_server_error"
}{
"type": "https://docs.payven.com.tr/errors/connector_unavailable",
"title": "Konnektör erişilemez",
"status": 503,
"code": "connector_unavailable"
}Karta ait puan bakiyesini sorgula
curl --request POST \
--url https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"card": {
"holder_name": "<string>",
"number": "<string>",
"expire_month": "<string>",
"expire_year": "<string>",
"cvv": "<string>"
},
"extra_properties": {}
}
'import requests
url = "https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry"
payload = {
"transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"card": {
"holder_name": "<string>",
"number": "<string>",
"expire_month": "<string>",
"expire_year": "<string>",
"cvv": "<string>"
},
"extra_properties": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
transaction_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
card: {
holder_name: '<string>',
number: '<string>',
expire_month: '<string>',
expire_year: '<string>',
cvv: '<string>'
},
extra_properties: {}
})
};
fetch('https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'transaction_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'card' => [
'holder_name' => '<string>',
'number' => '<string>',
'expire_month' => '<string>',
'expire_year' => '<string>',
'cvv' => '<string>'
],
'extra_properties' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry"
payload := strings.NewReader("{\n \"transaction_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"card\": {\n \"holder_name\": \"<string>\",\n \"number\": \"<string>\",\n \"expire_month\": \"<string>\",\n \"expire_year\": \"<string>\",\n \"cvv\": \"<string>\"\n },\n \"extra_properties\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"transaction_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"card\": {\n \"holder_name\": \"<string>\",\n \"number\": \"<string>\",\n \"expire_month\": \"<string>\",\n \"expire_year\": \"<string>\",\n \"cvv\": \"<string>\"\n },\n \"extra_properties\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://vpos-sandbox.payven.com.tr/api/v1/payments/{transaction_id}/point-inquiry")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transaction_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"card\": {\n \"holder_name\": \"<string>\",\n \"number\": \"<string>\",\n \"expire_month\": \"<string>\",\n \"expire_year\": \"<string>\",\n \"cvv\": \"<string>\"\n },\n \"extra_properties\": {}\n}"
response = http.request(request)
puts response.read_body{
"transaction_id": "8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6",
"status": "completed",
"is_success": true,
"message": "İşlem başarıyla tamamlandı",
"error_code": "bank_declined",
"provider_error_code": "51",
"extra_properties": {}
}{
"type": "https://docs.payven.com.tr/errors/bad_request",
"title": "Geçersiz istek",
"status": 400,
"code": "bad_request",
"detail": "amount.amount alanı zorunlu.",
"correlation_id": "9f1c8e76-2a3b-4f12-9c8d-12cb24a8a8a8"
}{
"type": "https://docs.payven.com.tr/errors/invalid_token",
"title": "Geçersiz token",
"status": 401,
"code": "invalid_token",
"detail": "Access token geçersiz veya süresi dolmuş — refresh edin."
}{
"type": "https://docs.payven.com.tr/errors/forbidden",
"title": "Yetki yok",
"status": 403,
"code": "forbidden",
"detail": "Bu rol bu kaynağı göremez."
}{
"type": "https://docs.payven.com.tr/errors/resource_not_found",
"title": "Kaynak bulunamadı",
"status": 404,
"code": "resource_not_found"
}{
"type": "https://docs.payven.com.tr/errors/idempotency_key_in_use",
"title": "Idempotency-Key çakışması",
"status": 409,
"code": "idempotency_key_in_use",
"detail": "Bu Idempotency-Key daha önce farklı bir istek gövdesi ile kullanıldı."
}{
"type": "https://docs.payven.com.tr/errors/bank_declined",
"title": "Banka işlemi reddetti",
"status": 422,
"code": "bank_declined",
"detail": "Yetersiz bakiye (banka kodu: 51)",
"provider_error_code": "51"
}{
"type": "https://docs.payven.com.tr/errors/rate_limit_exceeded",
"title": "İstek limiti aşıldı",
"status": 429,
"code": "rate_limit_exceeded"
}{
"type": "https://docs.payven.com.tr/errors/internal_server_error",
"title": "Sunucu hatası",
"status": 500,
"code": "internal_server_error"
}{
"type": "https://docs.payven.com.tr/errors/connector_unavailable",
"title": "Konnektör erişilemez",
"status": 503,
"code": "connector_unavailable"
}Authorizations
Identity servisinden alinan Keycloak JWT. Format: Authorization: Bearer <token>. Token alma: POST /api/v1/auth/{slug}/token
Path Parameters
Body
Response
OK
- Option 1
- Option 2
Yazma operasyonlarından (POST /payments, /refund, /void, /capture) dönen sonuç.
Payven tarafından atanan benzersiz işlem kimliği. Sorgulama / aksiyon endpoint'lerinde URL parametresi olarak kullanılır.
"8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6"
İşlemin mevcut durumu: pending, pending_3ds, authorized, completed, failed, voided, refunded, partially_refunded.
"completed"
Operasyon başarılı mı? Geçiş döneminde tutuluyor — yeni kodlarda HTTP status kodunu konuşturun (2xx başarı, 4xx/5xx hata).
true
İnsan-okur durum mesajı.
"İşlem başarıyla tamamlandı"
Yalnızca başarısız işlemlerde dolar — Payven canonical hata kodu.
"bank_declined"
Yalnızca başarısız işlemlerde dolar — bankanın orijinal yanıt kodu.
"51"
Banka-spesifik ek alanlar: auth_code, host_reference, provider_transaction_id, processed_at vb.
Show child attributes
Show child attributes