Sipay Wallet Api
  1. Webhook
Sipay Wallet Api
  • Overview
    • Sipay Business API
    • Partner Wallet Flow Guide
  • Authentication
    • Get Access Token
      POST
  • Account
    • PersonalAccount
      • Register Personal Account
      • Get Personal Account
      • Check Personal Wallet (AccountNumber)
      • Check Personal Wallet (PhoneNumber)
      • Submit KYC Form
      • Personal List By Filter
      • Update Personal Account
      • Get Personal Bank Account List By Filter
    • BusinessAccount
      • Register Business Account
      • Get Business Account
      • Business List By Filter
      • Check Business Wallet
      • Business Account Submit KYC Form
      • Update Business Account
      • Get Business Bank Account List By Filter
      • Create Business Bank Account
      • Update Business Bank Account
    • PersonalAccount & BusinessAccount
      • Account Balance Inquiry
      • Get KYC Detail
      • Tenant Bank List By Filter
  • Digital KYC
    • Status
      POST
    • Get Identity Info
      POST
    • Verify Address
      POST
    • Submit Digital KYC Additional Fields
      POST
    • Completed Digital KYC
      POST
  • Wallet
    • Create Wallet For Business Account
      POST
    • Create Wallet For Personal Account
      POST
    • Wallet Info
      POST
    • Wallet List By Filter
      POST
  • Transaction
    • Topup Credit Card
      • Topup Credit Card
      • Request Refund Topup Credit
    • Wallet To Wallet Transfer
      • Personal To Personal Transfer
      • Personal To Business Transfer
      • Business To Personal Transfer
      • Business To Business Transfer
      • Transfer To Virement
    • Withdraw To Bank
      • Withdrawal To Bank Instant
      • Send Money To Bank Account
    • Payment
      • Payment
      • Refund Payment Instant
    • Cashback
      • Cashback
      • Cashback Credit
    • TR QR Code
      • Read TR QR Code
      • Start TR QR Code
      • Get TR QR Code
    • QR Personal To Personal
      • Create QR Personal To Personal Transfer
      • Read QR Personal To Personal Transfer
      • Check QR Personal To Personal Transfer
      • Approve QR Personal To Personal Transfer
    • QR Payment
      • Create QR Payment
      • Read QR Payment
      • Check QR Payment Status
      • Approve QR Payment
  • Loyalty
    • Add Loyalty Program
    • Increase Loyalty Balance
    • Decrease Loyalty Balance
    • Loyalty Payment
  • Card Package
    • Virtual Card
      • Create Card
      • Get Card Info
    • Physical Card
      • Create Prepaid Card
      • Get Card Last Courier Activity
      • Set Card Active and Set Pin
      • Personalize Noname Prepaid Card
      • Validation For Expire Date and Cvv
    • Virtual Card & Physical Card
      • Get Payment Provider Media List By Filter
      • Set Card Pin
      • Update Card Pin
      • Set Card Random Pin
      • Set Card Mobile Phone
      • Set Card Limit and Restriction
      • Get Card Limit and Restriction
      • Set Card As Active
      • Set Card As Passive
      • Set Card As Lost
      • Close Card As Stolen
      • Close Card Permanently
      • Create Card Inquiry
      • Card Transaction Failed List
  • Metropol Kart Entegrasyonu
    • Add Provider Media To Wallet
    • Create 3rd Party QR Code
    • Begin 3rd Party QR Code Payment
    • Complete 3rd Party QR Code Payment
  • Invoice Payment
    • Get Cities
    • Get Product Types
    • Get Products By City And Type
    • Get Product Detail By Product ID
    • Get Invoices By Product And Subscriber
    • Make Payment
  • Transaction Data
    • Summary Record By Filter
    • Get Request Withdraw List By Filter
    • Get Request Withdraw By Ext Id
    • Transaction Receipt
  • Static Data
    • Get Province City List
    • Get City List By Province ID
    • Get Job List
    • Get Country List
  • Webhook
    • Bankaya Para Transferi Webhook
    • Para Yükleme Webhook
    • Kart Statü Değişimleri Webhook
    • Hesap Statü Değişimleri Webhook
    • KYC Statü Değişimleri Webhook
    • KYC 20 Statü Webhook
    • Dijital KYC Webhook
    • Hesap Bilgileri Değişimi Webhook
    • Kartlı Ödemeler ve İadeleri Webhook
    • Cashback Webhook
    • Cüzdanlar Arası Para Transferi Webhook
  • Webhook EN
    • Bank Transfer Webhook
    • Top-up Webhook
    • Card Status Change Webhook
    • Account Status Change Webhook
    • KYC Status Change Webhook
    • KYC 20 Status Webhook
    • Digital KYC Webhook
    • Account Information Change Webhook
    • Card Payments and Refunds Webhook
    • Cashback Webhook
    • Wallet to Wallet Transfer Webhook
  1. Webhook

Kartlı Ödemeler ve İadeleri Webhook

Kartlı Ödeme#

Kartlı ödemelerde aşağıdaki örnek yapıdaki webhook gönderilmektedir :
{
   "id": 2507214992247992834,
  "tenant_id": 7193628450192736815,
  "tx_group_correlation_id": 0,
  "tx_ref_correlation_id": 0,
  "wallet_id": 2505263421632657961,
  "transaction_type_id": 5001,
  "transaction_type": "P2B Payment | IsCashinTx = false",
  "transaction_status_id": 20,
  "transaction_status": "NormalCompleted",
  "result_code": "Success",
  "tx_additional_data_json": "{\"Message\":{\"TenantId\":5,\"SenderAccountNumber\":\"6156574429\",\"SenderWalletNumber\":\"513623659\",\"ExtTransactionId\":\"4536153331213333413244315869\",\"CurrencyCode\":\"TRY\",\"Amount\":10.0,\"Description\":\"bigchef\",\"ReceiverWalletId\":2409031531954561779,\"HashKey\":null,\"ChannelType\":null,\"SourceType\":null,\"MediaIdentifier\":\"434610ysmtoy0429\",\"TerminalNo\":\"\",\"Rrn\":null,\"Mcc\":null,\"AcquirerId\":null,\"MerchantId\":null,\"QRData\":null,\"IsLoginlessQr\":false,\"NationalSwitchId\":null},\"BalanceChanges\":{\"Sender\":{\"Before\":{\"PaymentAvailable\":0.0000,\"PaymentUnavailable\":0.0000,\"CashAvailable\":10230.0000,\"CashUnavailable\":0.0000},\"After\":{\"PaymentAvailable\":0.0,\"PaymentUnavailable\":0.0000,\"CashAvailable\":10220.000000,\"CashUnavailable\":0.0000}},\"Receiver\":{\"Before\":null,\"After\":null}},\"AccountInfo\":{\"Sender\":{\"FullName\":\"Barış Toper\",\"AccountId\":\"2505266705517345361\",\"AccountNumber\":\"6156574429\",\"WalletNumber\":\"513623659\",\"AccountTypeId\":\"1\",\"KycLevelCode\":\"40\",\"GroupCode\":null,\"IsNeedOpenBankingBalanceChangeNotify\":false,\"FastIban\":\"TR880083801024000513623659\"},\"Receiver\":null}}",
  "created_date_utc": "2025-07-21T11:30:44.2404324Z",
  "updated_date_utc": "2025-07-21T11:30:44.2404324Z",
  "completed_date_utc": "2025-07-21T11:30:44.6588487Z",
  "financial_process_completed_date_utc": null,
  "is_financial_process_completed": false,
  "to_wallet_id": 2409031531954561779,
  "tx_base_amount": 10.0000,
  "tx_additional_fee": 0.0000,
  "tx_amount_with_additional_fee": 10.0000,
  "currency_code": "TRY",
  "tx_end_user_preview_json": "",
  "tx_pre_financial_acquired_record_json": null,
  "tx_financial_acquired_record_json": "{\r\n  \"Id\": 981168,\r\n  \"TenantId\": 7193628450192736815,\r\n  \"TxCorrelationId\": 2507214992247992834,\r\n  \"TxSenderWalletId\": 2505263421632657961,\r\n  \"TxReceiverWalletId\": 2409031531954561779,\r\n  \"CommissionTypeLevel\": 3,\r\n  \"Currency\": \"TRY\",\r\n  \"TransactionType\": \"PYWLT_PERSONAL\",\r\n  \"TransactionBaseAmount\": 10.00,\r\n  \"CommissionRateAmount\": 0.0000,\r\n  \"CommissionFixedAmount\": 0.0000,\r\n  \"IsNeedSettlement\": true,\r\n  \"SettlementHour\": 0,\r\n  \"SettlementDay\": 0,\r\n  \"IsCancelled\": false,\r\n  \"IsFinancialProcessCompleted\": false,\r\n  \"AutoSettlement\": true,\r\n  \"CreatedDateUtc\": \"2025-07-21T11:30:44.24+00:00\",\r\n  \"CancelDateUtc\": null\r\n}",
  "from_description": "BARIŞ TOPER",
  "to_description": "BIGCHEF",
  "tx_description": "bigchef",
  "kyc_level_id": 40,
  "from_account_type_id": 1,
  "from_account_id": 2505266705517345361,
  "from_wallet_number": "513623659",
  "from_account_number": "6156574429",
  "to_account_number": "7181735939",
  "to_account_type_id": 2,
  "to_account_id": 2409031579540992024,
  "to_wallet_number": "1809672675",
  "is_need_settlement": false,
  "settlement_day": 0,
  "ext_transaction_id": "4536153331213333413244315869",
  "from_user_kyc_info": null,
  "to_user_kyc_info": null,
  "source_type": null,
  "channel_type": null,
  "media_identifier": "434610ysmtoy0429",
  "terminal_no": "",
  "media_type": "VirtualCard",
  "provider_id": "CardPackage",
  "to_account_tx_base_amount": 10.0000,
  "to_account_tx_additional_fee": 0.0000,
  "to_account_tx_amount_with_additional_fee": 10.0000,
  "from_ext_account_number": null,
  "to_ext_account_number": null,
  "from_group_code": null,
  "to_group_code": null,
  "receipt_number": "SPYDM_250000163551",
  "ip_address": "",
  "client_port": ""
}

Kartlı Ödeme İadesi (Tam Tutar İade)#

Kartlı ödemelerde iade işlemi tam tutarda yapılırsa, aşağıdaki örnek yapıdaki webhook gönderilir.
(Tutarın tamamı iade edildiği için, ana işlem İptal Tamamlandı veya İade Tamamlandı olarak görünmektedir.) :
{
  "id": 2507212188565852946,
  "tenant_id": 7193628450192736815,
  "tx_group_correlation_id": 0,
  "tx_ref_correlation_id": 0,
  "wallet_id": 219332603254795277,
  "transaction_type_id": 5001,
  "transaction_type": "P2B Payment | IsCashinTx = false",
  "transaction_status_id": 40,
  "transaction_status": "CancelCompleted",
  "result_code": "Success",
  "tx_additional_data_json": "{\"Message\":{\"TenantId\":7193628450192736815,\"SenderAccountNumber\":\"4241989968\",\"SenderWalletNumber\":\"1129966226\",\"ExtTransactionId\":\"44833443334334444675358521\",\"CurrencyCode\":\"TRY\",\"Amount\":100.0,\"Description\":\"\",\"ReceiverWalletId\":2407187756455652812,\"HashKey\":\"\",\"ChannelType\":\"\",\"SourceType\":\"\",\"MediaIdentifier\":\"434610shoofq4568\",\"TerminalNo\":\"21521521521\",\"Rrn\":\"315200319182\",\"Mcc\":\"5411\",\"AcquirerId\":\"12345678901\",\"MerchantId\":\"\",\"QRData\":null,\"IsLoginlessQr\":false,\"NationalSwitchId\":null},\"BalanceChanges\":{\"Sender\":{\"Before\":{\"PaymentAvailable\":10.0000,\"PaymentUnavailable\":0.0000,\"CashAvailable\":130.0000,\"CashUnavailable\":0.0000},\"After\":{\"PaymentAvailable\":0.0,\"PaymentUnavailable\":0.0000,\"CashAvailable\":40.000000,\"CashUnavailable\":0.0000}},\"Receiver\":{\"Before\":null,\"After\":null}},\"AccountInfo\":{\"Sender\":{\"FullName\":\"Barış Toper\",\"AccountId\":\"219364386012785677\",\"AccountNumber\":\"4241989968\",\"WalletNumber\":\"1129966226\",\"AccountTypeId\":\"1\",\"KycLevelCode\":\"40\",\"GroupCode\":null,\"IsNeedOpenBankingBalanceChangeNotify\":false,\"FastIban\":\"TR660083801024001129966226\"},\"Receiver\":null}}",
  "created_date_utc": "2025-07-21T13:05:02.4010412Z",
  "updated_date_utc": "2025-07-21T13:05:15.9251387Z",
  "completed_date_utc": "2025-07-21T13:05:02.4218986Z",
  "financial_process_completed_date_utc": null,
  "is_financial_process_completed": false,
  "to_wallet_id": 2407187756455652812,
  "tx_base_amount": 100.0000,
  "tx_additional_fee": 0.0000,
  "tx_amount_with_additional_fee": 100.0000,
  "currency_code": "TRY",
  "tx_end_user_preview_json": "",
  "tx_pre_financial_acquired_record_json": null,
  "tx_financial_acquired_record_json": "{\r\n  \"Id\": 981229,\r\n  \"TenantId\": 5,\r\n  \"TxCorrelationId\": 2507212188565852946,\r\n  \"TxSenderWalletId\": 219332603254795277,\r\n  \"TxReceiverWalletId\": 2407187756455652812,\r\n  \"CommissionTypeLevel\": 3,\r\n  \"Currency\": \"TRY\",\r\n  \"TransactionType\": \"PYWLT_PERSONAL\",\r\n  \"TransactionBaseAmount\": 100.00,\r\n  \"CommissionRateAmount\": 0.0000,\r\n  \"CommissionFixedAmount\": 0.0000,\r\n  \"IsNeedSettlement\": true,\r\n  \"SettlementHour\": 0,\r\n  \"SettlementDay\": 0,\r\n  \"IsCancelled\": false,\r\n  \"IsFinancialProcessCompleted\": false,\r\n  \"AutoSettlement\": true,\r\n  \"CreatedDateUtc\": \"2025-07-21T13:05:02.4+00:00\",\r\n  \"CancelDateUtc\": null\r\n}",
  "from_description": "BARIŞ TOPER",
  "to_description": "",
  "tx_description": "",
  "kyc_level_id": 40,
  "from_account_type_id": 1,
  "from_account_id": 219364386012785677,
  "from_wallet_number": "1129966226",
  "from_account_number": "4241989968",
  "to_account_number": "2379218271",
  "to_account_type_id": 2,
  "to_account_id": 2407187742661807742,
  "to_wallet_number": "990392096",
  "is_need_settlement": false,
  "settlement_day": 0,
  "ext_transaction_id": "44833443334334444675358521",
  "from_user_kyc_info": null,
  "to_user_kyc_info": null,
  "source_type": "",
  "channel_type": "",
  "media_identifier": "434610shoofq4568",
  "terminal_no": "21521521521",
  "media_type": "VirtualCard",
  "provider_id": "CardPackage",
  "to_account_tx_base_amount": 100.0000,
  "to_account_tx_additional_fee": 0.0000,
  "to_account_tx_amount_with_additional_fee": 100.0000,
  "from_ext_account_number": null,
  "to_ext_account_number": null,
  "from_group_code": null,
  "to_group_code": null,
  "receipt_number": "SPYDM_250000163566",
  "ip_address": "",
  "client_port": ""
}

Kartlı Ödeme İadesi (Parçalı İade)#

Kartlı ödemelerde parçalı iade olursa aşağıdaki örnek yapıdaki webhook gönderilmektedir:
{
 "id": 2507210574061775031,
  "tenant_id": 7193628450192736815,
  "tx_group_correlation_id": 0,
  "tx_ref_correlation_id": 2507216521591968757,
  "wallet_id": 2407187756455652812,
  "transaction_type_id": 10001,
  "transaction_type": "P2B Payment Refund | IsCashinTx = true",
  "transaction_status_id": 20,
  "transaction_status": "NormalCompleted",
  "result_code": "Success",
  "tx_additional_data_json": "{\"Message\":{\"TenantId\":7193628450192736815,\"TxCorrelationId\":2507216521591968757,\"ExtTransactionId\":\"448334444675358521\",\"CurrencyCode\":\"TRY\",\"RefundAmount\":10.0000,\"Description\":\"\",\"IsCustomLoyaltyRefund\":false,\"CustomLoyaltyRefundAmount\":null},\"BalanceChanges\":{\"Sender\":{\"Before\":{\"PaymentAvailable\":0.00,\"PaymentUnavailable\":0.00,\"CashAvailable\":40.00,\"CashUnavailable\":0.00},\"After\":{\"PaymentAvailable\":0.00,\"PaymentUnavailable\":0.00,\"CashAvailable\":50.00,\"CashUnavailable\":0.00}},\"Receiver\":{\"Before\":null,\"After\":null}},\"AccountInfo\":{\"Sender\":{\"FullName\":\"Barış Toper\",\"AccountId\":\"219364386012785677\",\"AccountNumber\":\"4241989968\",\"WalletNumber\":\"1129966226\",\"AccountTypeId\":\"1\",\"KycLevelCode\":\"40\",\"GroupCode\":null,\"IsNeedOpenBankingBalanceChangeNotify\":false,\"FastIban\":\"TR660083801024001129966226\"},\"Receiver\":null}}",
  "created_date_utc": "2025-07-21T13:10:05.5797773Z",
  "updated_date_utc": "2025-07-21T13:10:05.5797773Z",
  "completed_date_utc": "2025-07-21T13:10:06.0447978Z",
  "financial_process_completed_date_utc": null,
  "is_financial_process_completed": false,
  "to_wallet_id": 219332603254795277,
  "tx_base_amount": 10.0000,
  "tx_additional_fee": 0.0000,
  "tx_amount_with_additional_fee": 10.0000,
  "currency_code": "TRY",
  "tx_end_user_preview_json": "",
  "tx_pre_financial_acquired_record_json": null,
  "tx_financial_acquired_record_json": null,
  "from_description": "BARİS",
  "to_description": "BARIŞ TOPER",
  "tx_description": "",
  "kyc_level_id": 40,
  "from_account_type_id": 2,
  "from_account_id": 2407187742661807742,
  "from_wallet_number": "990392096",
  "from_account_number": "2379218271",
  "to_account_number": "4241989968",
  "to_account_type_id": 1,
  "to_account_id": 219364386012785677,
  "to_wallet_number": "1129966226",
  "is_need_settlement": false,
  "settlement_day": 0,
  "ext_transaction_id": "2507216521591968757",
  "from_user_kyc_info": null,
  "to_user_kyc_info": null,
  "source_type": null,
  "channel_type": null,
  "media_identifier": null,
  "terminal_no": null,
  "media_type": "",
  "provider_id": null,
  "to_account_tx_base_amount": 10.0000,
  "to_account_tx_additional_fee": 0.0000,
  "to_account_tx_amount_with_additional_fee": 10.0000,
  "from_ext_account_number": null,
  "to_ext_account_number": null,
  "from_group_code": null,
  "to_group_code": null,
  "receipt_number": "SPYDM_250000163568",
  "ip_address": "",
  "client_port": ""
}
Modified at 2025-07-24 12:50:05
Previous
Hesap Bilgileri Değişimi Webhook
Next
Cashback Webhook
Built with