Payantis Platform, Kurumların belirli olaylar (örneğin, işlem onayı, kart aktivasyonu, veya hatalı şifre girişi) gerçekleştiğinde anlık bildirimler almasını sağlayan webhook'lara sahiptir. Bu sayede Kurumlar sistemlerini gerçek zamanlı olarak güncel tutabilir ve olaylar için otomatik aksiyonlar alabilirler.

Payantis Platform’da webhook mekanizmasını kullanmak isteyen kurumlar aşağıdaki adımları takip ederek gerekli yapılandırmaları yapabilirler:

Webhook Endpoint’i Hazırlama: Kurumlar, kendi sistemlerinde gelen webhook çağrılarını alabilecek bir HTTP(S) endpoint oluşturmalıdır. Bu endpoint POST isteği alacak şekilde yapılandırılmalı ve JSON formatında gelen verileri işleyebilmelidir.

Webhook Endpoint’i Payantis Platform’a Kaydetme: Kurum, Payantis Platformunda bulunan aşağıdaki API'leri kullanarak webhook kullanımını konfigüre edebilir. Bu konfigürasyon sırasında olay türleri, kurum endpoint ve erişim bilgileri belirtilir.

Get Registered Webhooks: Kayıtlı webhook'ları döner.

Unregister: Kayıtlı bir webhook'un sistemden kaldırılmasını sağlar.

Update: Bir webhook kaydını günceller.

Webhook Yanıtları ve Retry Mekanizması: Kurum, webhook çağrılarına 2xx HTTP yanıtı vermelidir. Eğer çağrı başarısız olursa, Payantis PLatform belirli bir retry politikası kapsamında çağrıyı tekrar gönderebilir. Çok fazla başarısız deneme sonrası webhook geçici olarak devre dışı bırakılabilir.

Payantis Platform Webhook Olayları

Platform'da bulunan webhook olayları şunlardır:

Olay	Ne zaman gerçekleşir
CustomerCreated	Yeni bir müşteri oluştuğunda
CardCreated	Yeni bir kart oluştuğunda
CardStatusChanged	Kartın statüsü değiştiğinde. Örneğin kart Aktif durumdan Kapalı duruma geçtiğinde.
CardLinkedToCustomer	Noname bir kart müşteri ile ilişkilendirildiğine
CardUnLinkedFromCustomer	Noname bir kartın müşteri ile ilişkisi kaldırıldığında
PersoCreated	Kart için basım talebi oluştuğunda
PersoStatusChanged	Kartın basım talebi ile ilgili güncellemeler olduğunda. Örneğin kartın basım dosyası oluştuğunda, ya da basım tamamlandğında.
DeliveryCreated	Kartın kurye ile teslim süreci başlatıldığında
DeliveryStatusChanged	Kartın kurye ile tesliminde durum değişikliği olduğunda. Örneğin, kart teslim edildiğinde, ya da müşteri adreste bulunamadığında.
SuccessfulTransaction	Kart başarılı bir işlem yaptığında
UnsuccessfulTransaction	Kart başarısız/reddedilen bir işlem yaptığında
TransactionTransition	Kartın yaptığı işlemin durumu değiştiğinde. Örneği işlem iptal olduğunda, işlemin kısmi iptali gerçekleştiğinde, takas eşleşmesi olduğunda ya da işlem takası gelmemesi nedeni ile zaman aşımına uğradığında
ThreeDSecureTransition	İşlemin 3ds akışına ait bir olay gerçekleştiğinde
DisputeTransition	Başlatılan bir harcama itirazında sürecine ilişkin bir durum değişikliği olduğunda
PinSet	Karta pin atandığında
PinChanged	Kartın mevcut pini değiştiğinde
PinBlocked	Ard arda hatalı şifre girişi nedeni ile kartın şifresi blokelendiğinde
Cvv2Blocked	Ard arda hatalı cvv2 girişi nedeni ile kartın cvv2 si blokelendiğinde

Webhook Olaylarında İletilen Bilgiler

Bir olay oluştuğunda bu olay ile ilgili detaylı bilgiler Kurum'a iletilir. Olay türüne göre bu bilgiler aşağıda örneklendirilmiştir.

CustomerCreated

{
  "Name": "CustomerCreated",
  "Data": {
    "Id": 22,
    "CustomerNo": null,
    "Name": "troy",
    "Midname": "Mid",
    "Surname": "test",
    "Nationality": "Turkey",
    "Gender": "Male",
    "MaritalStatus": "Single",
    "DisabledType": "Normal",
    "BirthDate": "1983-01-01",
    "BirthPlace": null,
    "FatherName": "BKM",
    "MotherMaidenName": "motherMaidenName",
    "MotherName": "BKM",
    "CreationTime": "2025-01-24T18:32:26.400959Z",
    "CreatorId": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
Id	Integer	21
CustomerNo	String
Name	String
Midname	String
Surname	String
Nationality	String
Gender	String	Female,Male
MaritalStatus	String	Married,Single
DisabledType	String	Normal,Older,etc
BirthDate	Date
BirthPlace	String
FatherName	String
MotherMaidenName	String
MotherName	String
CreationTime	DateTime
CreatorId	String(UUID)

CardCreated

{
  "Name": "CardCreated",
  "Data": {
    "CardTokenId": 813,
    "MaskedCardNo": "51965300****7442",
    "CustomerNo": "1233651",
    "DateTime": "2025-01-24T18:05:37.90813Z",
    "CreateUser": "2678d05f-afec-464a-9cfe-78f12c3b2fe9",
    "CardDci": "Prepaid",
    "IsChildCard": true,
    "PersonalizedNameLine1": "Ercan Sanal Kart",
    "PersonalizedNameLine2": null,
    "Status": "PendingActivation",
    "CardProductName": "mc sanal",
    "Bin": "51965300",
    "ExpireDate": 2801,
    "Brand": "MasterCard",
    "ProductType": "Virtual"
  }
}

Adı	Data Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
CustomerNo	String
DateTime	DateTime
CreateUser	String(UUID)
CardDci	String	Debit,Prepaid,Credit
IsChildCard	Boolean
PersonalizedNameLine1	String
PersonalizedNameLine2	String
Status	String	PendingActivation,Active,Lost,Stolen,Suspended,Closed,Fraud
CardProductName	String
Bin	String
ExpireDate	Integer	YYMM formatında kartın son kullanma tarihi
Brand	String	Visa,MasterCard,Troy,JCB,Diners,UnionPay,Amex,ProprietaryDomestic
ProductType	String	Emv,Magnetic,Virtual,Hce

CardStatusChanged

{
  "Name": "CardStatusChanged",
  "Data": {
    "CardTokenId": 797,
    "MaskedCardNo": "97927100****2026",
    "OldStatus": "PendingActivation",
    "NewStatus": "Active",
    "OldReason": null,
    "NewReason": "CustomerRequest",
    "DateTime": "2025-01-23T06:24:26.554Z",
    "UpdateUser": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Data Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
OldStatus	String	PendingActivation,Active,Lost,Stolen,Suspended,Closed,Fraud
NewStatus	String	PendingActivation,Active,Lost,Stolen,Suspended,Closed,Fraud
OldReason	String	CustomerRequest,TenantRequest,SuspiciousTransaction,DeliveryFailed,SuspectedFraud,ClonedCard,FraudulentApplication
NewReason	String	CustomerRequest,TenantRequest,SuspiciousTransaction,DeliveryFailed,SuspectedFraud,ClonedCard,FraudulentApplication
DateTime	DateTime
UpdateUser	String

CardLinkedToCustomer

{
  "Name": "CardLinkedToCustomer",
  "Data": {
    "CardTokenId": 702,
    "MaskedCardNo": "412199******5142",
    "CustomerNo": "1233651",
    "DateTime": "2025-01-16T13:43:07.57258Z",
    "UpdateUser": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Data Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
CustomerNo	Integer
DateTime	DateTime
UpdateUser	String

CardUnLinkedFromCustomer

{
  "Name": "CardUnLinkedFromCustomer",
  "Data": {
    "CardTokenId": 702,
    "MaskedCardNo": "412199******5142",
    "CustomerNo": null,
    "DateTime": "2025-01-16T13:43:07.57258Z",
    "UpdateUser": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Data Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
DateTime	DateTime
UpdateUser	String(UUID)

PersoCreated

{
  "Name": "PersoCreated",
  "Data": {
    "CardTokenId": 787,
    "MaskedCardNo": "97927100****0976",
    "CustomerNo": "1233651",
    "DateTime": "2025-01-24T18:08:59.718064Z",
    "CreateUser": "2678d05f-afec-464a-9cfe-78f12c3b2fe9",
    "PersoOfficeName": null,
    "CourierName": null
  }
}

Adı	Veri Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
CustomerNo	String
DateTime	DateTime
CreateUser	String(UUID)
PersoOfficeName	String
CourierName	String

PersoStatusChanged

{
  "Name": "PersoStatusChanged",
  "Data": {
    "CardTokenId": 787,
    "MaskedCardNo": "97927100****0976",
    "CustomerNo": "1233651",
    "OldStatus": "Requested",
    "NewStatus": "Waiting",
    "Barcode": null,
    "UpdateUser": "2678d05f-afec-464a-9cfe-78f12c3b2fe9",
    "DateTime": "2025-01-24T18:13:19.659928Z",
    "PersoOfficeName": "Perso Card",
    "CourierName": "test"
  }
}

Adı	Veri Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
CustomerNo	String
OldStatus	String	Requested,Waiting,Processing,Error,Completed,Cancelled
NewStatus	String	Requested,Waiting,Processing,Error,Completed,Cancelled
QrCodeBarcode	String
UpdateUser	String(UUID)
DateTime	DateTime
PersoOfficeName	String
CourierName	String

DeliveryCreated

{
  "Name": "DeliveryCreated",
  "Data": {
    "CardTokenId": 787,
    "MaskedCardNo": "97927100****0976",
    "CustomerNo": "1233651",
    "Barcode": "869100000000149",
    "CourierName": "Courier Name",
    "DateTime": "2025-01-24T10:58:05.949083Z",
    "CreateUser": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
CustomerNo	String
DateTime	DateTime
CreateUser	String(UUID)
Barcode	String
CourierName	String

DeliveryStatusChanged

{
  "Name": "DeliveryStatusChanged",
  "Data": {
  "CardTokenId": 787,
  "MaskedCardNo": "97927100****0976",
  "CustomerNo": "1233651",
  "OldStatus" :"",
  "NewStatus" :"",
  "Barcode": "869100000000149",
  "CourierName": "Courier Name",
  "DateTime": "2025-01-24T10:58:05.949083Z",
  "User": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
CustomerNo	String
OldStatus	String
NewStatus	String
Barcode	String
CourierName	String
DateTime	DateTime
User	String(UUID)

PinSet

{
  "Name": "PinSet",
  "Data": {
    "CardTokenId": 61,
    "MaskedCardNo": "97927100****5396",
    "CustomerNo": "1233651",
    "DateTime": "2025-01-24T18:16:39.647857Z",
    "User": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
CardTokenId	long
MaskedCardNo	String
CustomerNo	String
DateTime	DateTime
User	String(UUID)

PinChanged

{
  "Name": "PinChanged",
  "Data": {
    "CardTokenId": 61,
    "MaskedCardNo": "97927100****5396",
    "CustomerNo": "1233651",
    "DateTime": "2025-01-24T18:19:06.911135Z",
    "User": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
CardTokenId	Integer
MaskedCardNo	String
CustomerNo	String
DateTime	DateTime
User	String(UUID)

PinBlocked

{
  "Name": "PinBlocked",
  "Data": {
  "CardTokenId": 61,
  "MaskedCardNo": "97927100****5396",
  "CustomerNo": "1233651",
  "DateTime": "2025-01-24T11:23:29.16495Z",
  "User": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
CardTokenId	Integer
MaskedCardNo	String
CustomerNo	String
DateTime	DateTime
User	String(UUID)

Cvv2Blocked

{
  "Name": "Cvv2Blocked",
  "Data": {
  "CardTokenId": 61,
  "MaskedCardNo": "97927100****5396",
  "CustomerNo": "1233651",
  "DateTime": "2025-01-24T11:23:29.16495Z",
  "User": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
CardTokenId	Integer
MaskedCardNo	String
CustomerNo	String
DateTime	DateTime
User	String(UUID)

SuccessfulTransaction

Her başarılı işlem oluştuğunda tetiklenir.

{
  "Name": "SuccessfulTransaction",
  "Data": {
    "Id": 9216,
    "TransactionResult": "Approved",
    "TransactionState": "Pending",
    "TransactionCategory": "Financial",
    "TransactionCode": "Purchase",
    "ResponseCode": "Approved",
    "TokenId": 95,
    "MaskedCardNo": "519653******5378",
    "TransactionAmount": 14.99,
    "TransactionCurrency": 949,
    "BillingAmount": 14.99,
    "BillingCurrency": 949,
    "Stan": 592217,
    "Mcc": 5992,
    "MccName": null,
    "PanSequenceNo": 2,
    "Rrn": "832085158297",
    "AuthNo": "237685",
    "ErrorCode": null,
    "ErrorDescription": null,
    "TerminalNo": "PS223344",
    "CardAcceptorNo": "ISYERI000000001",
    "LocalTransactionTime": "2025-04-12T12:44:56Z",
    "TransactionNetwork": "Domestic",
    "SettlementDate": null,
    "SettleMatchStatus": "Unmatched",
    "TransactionTime": "2025-04-12T12:45:15.486947Z",
    "CardAcceptorName": "ONTEST SIM ISYERI        ",
    "CardAcceptorCity": "ISTANBUL    ",
    "CardAcceptorCountry": " TR",
    "PosEntryMode": "MagneticStripe",
    "IsOffline": null,
    "AdditionalAmounts": [
      {
        "AdditionalAmountType": "TransactionFee",
        "Currency": 949,
        "Amount": 5,
        "TaxIncluded": true,
        "Taxes": [
          {
            "Name": "BSMV",
            "Amount": 0.24,
            "Currency": 949
          }
        ],
        "Source": "PayantisPlatform",
        "ReferenceId": 23
      }
    ],
    "CvcResultCode": null
  }
}

Adı	Veri Tipi	Olası Değerler
Id	Integer
TransactionResult	String	Approved, Voided
TransactionState	String	Pending
TransactionCategory	String	Financial, NonFinancial
TransactionCode	String
ResponseCode	String	Approved, OfflineApproved1 , OfflineApproved2, OfflineApproved3
TokenId	long
MaskedCardNo	String
TransactionAmount	Decimal
TransactionCurrency	Short
BillingAmount	Decimal
BillingCurrency	Short
Stan	Integer
Mcc	Integer
MccName	String
PanSequenceNo	Short
Rrn	String
AuthNo	String
ErrorCode	String
ErrorDescription	String
TerminalNo	String
CardAcceptorNo	String
LocalTransactionTime	DateTime
TransactionNetwork	String	Domestic, Onus, Visa, Mastercard, Diners
SettlementDate	DateTime
SettleMatchStatus	String	Matched, Unmatched
TransactionTime	DateTime
CardAcceptorName	String
CardAcceptorCity	String
CardAcceptorCountry	String
PosEntryMode	String	Unknown, ManualEntry, MagneticStripeNotFullRead, QrCode, OpticalCharacter, Chip, ContactlessChip, PanTokenEntry, CredentialOnFile, Fallback, ECommerce, NewGenerationPayment, MagneticStripe, ContactlessMagneticStripe, ChipUnreliableCvv
IsOffline	Boolean	true, false
AdditionalAmounts	Array	Array of objects
CvcResultCode	String	CvvFailed,CvvPassed,Cvv2Passed,Cvv2Failed, NotPerformed,Cvc2Unverified,Invalid, null

UnsuccessfulTransaction

Her başarısız/reddedilen işlem oluştuğunda tetiklenir.

{
  "Name": "UnsuccessfulTransaction",
  "Data": {
    "Id": 46453234,
    "TransactionResult": "Declined",
    "TransactionState": "Pending",
    "TransactionCategory": "Financial",
    "TransactionCode": "Purchase",
    "ResponseCode": "DuplicateMessage",
    "TokenId": 2483,
    "MaskedCardNo": "979271******3100",
    "TransactionAmount": 100,
    "TransactionCurrency": 949,
    "BillingAmount": 100,
    "BillingCurrency": 949,
    "Stan": 5,
    "Mcc": 4511,
    "MccName": null,
    "PanSequenceNo": 1,
    "Rrn": "512014000005",
    "AuthNo": null,
    "ErrorCode": "AUTH:00018",
    "ErrorDescription": "Bu finansal olmayan işlem daha önce işlenmiş",
    "TerminalNo": "12345678",
    "CardAcceptorNo": "111111101111111",
    "LocalTransactionTime": "2025-04-30T17:49:16Z",
    "TransactionNetwork": "Domestic",
    "SettlementDate": null,
    "SettleMatchStatus": "Unmatched",
    "TransactionTime": "2025-05-01T11:26:35.266Z",
    "CardAcceptorName": "BOGAZ HOTELLER           ",
    "CardAcceptorCity": "ISTANBUL     ",
    "CardAcceptorCountry": "TR",
    "PosEntryMode": "Chip",
    "IsOffline": false,
    "AdditionalAmounts": [],
    "CvcResultCode": null
  }
}

Adı	Veri Tipi	Olası Değerler
Id	Integer
TransactionResult	String	Declined
TransactionState	String	Pending
TransactionCategory	String	Financial, NonFinancial
TransactionCode	String
ResponseCode	String	ReferCardIssuer, ReferCardIssuerSpecialCondition, InvalidMerchant, PickUpCard, DoNotHonour, FileUpdateError, PickUpCardSpecialCondition, HonourWithId, TryAgain, InvalidTransaction, InvalidAmount, InvalidAccountNumber, NoSuchIssuer, UnableLocateRecordOnFile, OriginalDeclined, OriginalNotFound, FormatError, ExpiredCardPickUp, RestrictedCardPickUp, PinTryExceededPickUp, LostCardPickUp, StolenCardPickUp, InsufficientFunds, NoCheckingAccount, NoSavingsAccount, ExpiredCard, IncorrectPin, TransactionNotPermittedCardholder, TransactionNotPermittedTerminal, SuspectedFraud, ExceedsWithdrawalAmountLimit, RestrictedCard, SecurityViolation, ExceedsWithdrawalFrequencyLimit, ContactCardIssuer, PinNotChanged, PinTryExceeded, KeySynchronisationError, NoScriptAvailable, UnsafePin, ArqcFailed, ApprovalOfRequest, CannotVerifyPin, CryptographicFailure, UnacceptablePin, IssuerOrSwitchInoperative, UnknownFinancialInstitutionForRouting, ViolationOfLaw, ReconcilationError, SystemMalfunction, DuplicateMessage
TokenId	long
MaskedCardNo	String
TransactionAmount	Decimal
TransactionCurrency	Short
BillingAmount	Decimal
BillingCurrency	Short
Stan	Integer
Mcc	Integer
MccName	String
PanSequenceNo	Short
Rrn	String
AuthNo	String
ErrorCode	String
ErrorDescription	String
TerminalNo	String
CardAcceptorNo	String
LocalTransactionTime	DateTime
TransactionNetwork	String	Domestic, Onus, Visa, Mastercard, Diners
SettlementDate	DateTime
SettleMatchStatus	String	Unmatched
TransactionTime	DateTime
CardAcceptorName	String
CardAcceptorCity	String
CardAcceptorCountry	String
PosEntryMode	String	Unknown, ManualEntry, MagneticStripeNotFullRead, QrCode, OpticalCharacter, Chip, ContactlessChip, PanTokenEntry, CredentialOnFile, Fallback, ECommerce, NewGenerationPayment, MagneticStripe, ContactlessMagneticStripe, ChipUnreliableCvv
IsOffline	Boolean	true, false
AdditionalAmounts	Array	[]
CvcResultCode	String	CvvFailed,CvvPassed,Cvv2Passed,Cvv2Failed, NotPerformed,Cvc2Unverified,Invalid, null

TransactionTransition

{
  "Name": "TransactionTransition",
  "Data": {
    "TransactionId": 101,
    "EventType": "Reversal",
    "TransactionAmount": 12.5,
    "BillingAmount": 12.5,
    "DateTime": "2025-01-24T21:28:45.5416529+03:00"
  }
}

Adı	Veri Tipi	Olası Değerler
TransactionId	Integer
EventType	String	Reversal,ClearingMatched, Void, Expire, PartialReversal
TransactionAmount	Decimal
BillingAmount	Decimal
DateTime	DateTime

ThreeDSecureTransition

{
  "Name": "3dSecureTransition",
  "Data": {
  "AcsTransactionId": "9646e206-8749-4c91-b4d9-c10b0113c4d3",
  "CardTokenId": 811,
  "EventType": "VerifyAccount",
  "Result" : "INVALID_EXPIRY_DATE"
  "CreationTime": "2025-01-24T14:05:44.117048Z",
  "CreatorId": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
TransactionId	String(UUID)
CardTokenId	long
MaskedCardNo	String
EventType	String	VerifyAccount,ChallengeRequested,ChallangeNotification
DateTime	DateTime
CreatorId	String(UUID)

DisputeTransition

{
  "Name": "DisputeTransition",
  "Data": {
  "TransactionId": 21,
  "CardTokenId": 811,
  "MaskedCardNo": "51965300****4354",
  "EventType": "InProgress",
  "CreationTime": "2025-01-24T14:05:44.117048Z",
  "CreatorId": "2678d05f-afec-464a-9cfe-78f12c3b2fe9"
  }
}

Adı	Veri Tipi	Olası Değerler
TransactionId	Integer
CardTokenId	long
MaskedCardNo	String
EventType	String	InProgress,Cancelled, Won, Lost
DateTime	DateTime
CreatorId	String(UUID)

WebHook

Payantis Platform Webhook Olayları#

Webhook Olaylarında İletilen Bilgiler#

CustomerCreated#

CardCreated#

CardStatusChanged#

CardLinkedToCustomer#

CardUnLinkedFromCustomer#

PersoCreated#

PersoStatusChanged#

DeliveryCreated#

DeliveryStatusChanged#

PinSet#

PinChanged#

PinBlocked#

Cvv2Blocked#

SuccessfulTransaction#

UnsuccessfulTransaction#

TransactionTransition#

ThreeDSecureTransition#

DisputeTransition#