Satış WebHook

Açıklama: Öncelikle http://app.vepara.com.tr/merchant/apisetting adresindeki vepara üye işyeri panelinde satış web hook URL'nizi (anahtar, değer) ayarlamanız gerekir. Bu özelliği almak için, üye iş yerinin satın alma talebini gönderirken sale_web_hook_key ile faturayı göndermesi gerekir. Bu anahtar isteğe bağlıdır, ancak gönderilirse geçerli bir anahtar olmalıdır.

Her ödeme için, aşağıda verilen aşağıdaki parametrelerle satış webhook url'sine bir POST isteği gönderiyoruz.

Yanıt Doğrulama

Durum 1 payment_status == 1 ve transaction_type == “Auth” // İşlem başarılıdır ve işlem tutarı anında karttan düşülür.

Durum 2 payment_status == 1 and transaction_type == “Pre-Authorization” // İşlem başarılı olup, işlem tutarı kredi kartından bloke edilir. Bloke tutarın karttan çekilmesi için /api/confirmPayment çağırılmalıdır.

Durum 3 payment_status == 0 // İşlem başarısız.

Hash_key, isteğin Vepara'dan geldiğini doğrulamak için üye işyeri tarafında doğrulanmalıdır. Ayrıca İşlem Durumu servisi işlemin başarılı veya Başarısız olduğunu onaylar. Örnek doğrulama işlemi için bakınız Hash Doğrulama Örneği

Query Parameters

{
  "type": "object",
  "properties": {
    "vepara_status": {
        "type": "string",
        "example": "vepara_status=1",
        "required":  "Yes" 
    },
    "order_no": {
        "type": "string",
        "example": "order_no=162754070457149 - Vepara sipariş numarası",
        "required":  "Yes" 
    },
    "status_code": {
        "type": "string",
        "example": "status_code=100 - Vepara Status code, 100 başarılı işlem kodudur",
        "required":  "Yes" 
    },
     "status_description": {
        "type": "string",
        "example": "status_description=Approved - işlem açıklaması",
        "required":  "Yes" 
    },
     "vepara_payment_method": {
        "type": "string",
        "example": "vepara_payment_method=1",
        "required":  "Yes" 
    },
     "credit_card_no": {
        "type": "string",
        "example": "credit_card_no=450803**** 4509",
        "required":  "Yes" 
    },
     "transaction_type": {
        "type": "string",
        "example": "transaction_type=Auth transaction_type == “Auth” ",//işlem tutarı anında karttan düşülür. transaction_type == “Pre-Authorization” işlem tutarı daha sonra karttan düşülecektir.
        "required":  "Yes" 
    },
    "payment_status": {
        "type": "string",
        "example": "payment_status=1 - 1 veya 0 olabilir. 1=başarılı, 0=başarısız",
        "required":  "Yes" 
    },
    "payment_method": {
        "type": "string",
        "example": "payment_method=1 - 1= kredi kartı, 2= mobil, 3= Wallet/cüzdan",
        "required":  "Yes" 
    },
    "error_code": {
        "type": "string",
        "example": "error_code=100 - status_code değerinin parametresi",
        "required":  "Yes" 
    },
    "error": {
        "type": "string",
        "example": "error=Approved - status_description parametresinin değeri",
        "required":  "Yes" 
    },
    "status": {
        "type": "string",
        "example": "status=Completed",
        "required":  "Yes" 
    },
    "hash_key": {
        "type": "string",
        "example": "hash_key=4c63ed8a964ab9a3:f20f:WMnQTMI128rDslYQKRp Vepara'dan gelen talebi doğrulamak için",
        "required":  "Yes" 
    },
    
  },

}