Payantis Platform
Home
Payantis
Home
Payantis
  1. Payantis Platform
  • Payantis Platform
    • Payantis Platform
    • API Kullanımı
    • Temel Kavramlar
    • Kural Motoru
  • Issuing API
    • Payantis Issuing
    • Adım Adım Issuing API
    • Customer
      • Create Customer
      • Get or Create Customer
      • Get Customer
      • Get Customer List
      • Update Customer
      • Update Customer Segment
      • Upsert Address
      • Upsert Communication
      • Upsert Identification
      • Create Segment
      • Get Segments
      • Update Segment
      • Delete Segment
      • Create User Note
      • Get User Notes
    • Card
      • Create Card
      • Create Noname Card
      • Get Card List
      • Get Card
      • Get Card Details
      • Get Card Policy
      • Get Card Perso Info
      • Get Card Shipment Info
      • Renew Card
      • Detokenize Card
      • Link Noname Card To Customer
      • Unlink Noname Card
      • Update Card Status
      • Update Customer Card Statuses
      • Update Card Policy
      • Update Card Phone Number
      • Update Digital Slip Type
      • Update Auto Renewal Status
      • Cvv2 - Reset Counters
      • Cvv2 - Verify
      • Cvv2 - Get with Expire Date
      • Pin - Verify
      • Pin - Set
      • Pin - Change
      • Pin - Unblock
      • Pin - Set Random
      • Pin - Send via SMS
      • Creates User Note
      • Get User Notes
    • Product
      • Create Card Art
      • Create Card Bin Range
      • Create Card Product
      • Create Card Product Group
      • Get Card Art List
      • Get Card Bin List
      • Get Card Bin Range List
      • Get Card Product Group List
      • Get Card Product List
      • Get Card Product
      • Update Card Art Name
      • Update Card Bin Range
      • Update Card Product Group
      • Update Card Product
      • Update Card Product Contactless Limit
      • Delete Card Art
      • Delete Card Product Group
      • Delete Card Product
    • Transactions
      • Get Card Transactions
    • Velocity Controls
      • Create Velocity Control
      • Update Velocity Control
      • Get Velocity Control
      • Get Velocity Control List
      • Delete Velocity Control
      • Link
      • Unlink
      • Get Velocity Links
      • Get Card Velocity Limits
      • Card Velocity
      • Get Card Velocity
      • Delete Card Velocity
    • Authorization Controls
      • Create Authorization Control
      • Update Authorization Control
      • Link
      • Unlink
      • Get Authorization Controls
      • Get Links
      • Delete Authorization Control
    • Fees
      • Transaction Fee
        • Create
        • Get List
        • Get
        • Update
        • Delete a Transaction Fee
        • This API is used to link transaction fee.
        • This API is used to fetch linked transaction fee list.
        • Unlink a Transaction Fee
      • Card Issuance Fee
        • Creates a new Card Issuance Fee
        • Updates a Card Issuance Fee
        • Get a Card Issuance Fee detail
        • /api/v1/issuing/fee-management/card-issuance
        • Delete a Card Issuance Fee
        • This API is used to link card issuance fee.
        • This API is used to fetch linked card issuance fee list.
        • Unlink a card issuance Fee
      • Card Annual Fee
        • Creates a new Card Annual Fee
        • /api/v1/issuing/fee-management/card-annual
        • Updates a Card Annual Fee
        • Get a Card Annual Fee detail
        • Delete a Card Annual Fee
        • This API is used to link card annual fee.
        • This API is used to fetch linked card annual fee list.
        • Unlink a card annual Fee
    • WebHook
      • Register
      • Get Registered Webhooks
      • Unregister
      • Update
    • AuditLog
      • Get Card Audits
      • Get Product Audits
      • Get Policy Audits
    • Schemas
      • Payantis.Card.Dto.AuditLogCardListItemDto
      • Payantis.Card.Dto.AuditLogPolicyListItemDto
      • Payantis.Card.Dto.AuditLogProductListItemDto
      • Payantis.Framework.QueryBuilderFieldDto
      • Payantis.Issuing.Card.AddressDto
      • Payantis.Issuing.Card.AuthorizationCheckDto
      • Payantis.Issuing.Card.AuthorizationCheckLinkDto
      • Payantis.Issuing.Card.Backend.BaseCardPhysicalInfoDto
      • Payantis.Issuing.Card.Backend.BusinessDetail
      • Payantis.Issuing.Card.Backend.CardAccountStatisticInfoDto
      • Payantis.Issuing.Card.Backend.CardAutoRenewalStatusUpdateResult
      • Payantis.Issuing.Card.Backend.CardDetokenizeRequestDto
      • Payantis.Issuing.Card.Backend.CardDetokenizeResponseDto
      • Payantis.Issuing.Card.Backend.CardPhoneNumberUpdateRequestDto
      • Payantis.Issuing.Card.Backend.CardPhysicalInfoDto
      • Payantis.Issuing.Card.Backend.CardPolicyInfoDto
      • Payantis.Issuing.Card.Backend.CardProductInfoDto
      • Payantis.Issuing.Card.Backend.CardRenewalRequestDto
      • Payantis.Issuing.Card.Backend.CardRequestDto
      • Payantis.Issuing.Card.Backend.CardResponseInfoDto
      • Payantis.Issuing.Card.Backend.CardStatusInfoDto
      • Payantis.Issuing.Card.Backend.CardStatusUpdateRequestDto
      • Payantis.Issuing.Card.Backend.ContactlessLimitDto
      • Payantis.Issuing.Card.Backend.CreateCardArtDto
      • Payantis.Issuing.Card.Backend.CreateCardDto
      • Payantis.Issuing.Card.Backend.CreateCardProductDto
      • Payantis.Issuing.Card.Backend.CreateCustomerAddressDto
      • Payantis.Issuing.Card.Backend.CreateCustomerCommunicationDto
      • Payantis.Issuing.Card.Backend.CreateCustomerDto
      • Payantis.Issuing.Card.Backend.CreateCustomerIdentificationDto
      • Payantis.Issuing.Card.Backend.CreateUpdateAuthorizationCheckLinkDto
      • Payantis.Issuing.Card.Backend.CreateUpdateCardAnnualFeeLinkDto
      • Payantis.Issuing.Card.Backend.CreateUpdateCardIssuanceFeeLinkDto
      • Payantis.Issuing.Card.Backend.CreateUpdateCardProductGroupDto
      • Payantis.Issuing.Card.Backend.CreateUpdateTransactionFeeLinkDto
      • Payantis.Issuing.Card.Backend.CreateUpdateVelocityCheckLinkDto
      • Payantis.Issuing.Card.Backend.CreateVelocityCheckDto
      • Payantis.Issuing.Card.Backend.CustomerInfoDto
      • Payantis.Issuing.Card.Backend.FindCardResponseDto
      • Payantis.Issuing.Card.Backend.PinRequestDto
      • Payantis.Issuing.Card.Backend.TransactionCriteriaDto
      • Payantis.Issuing.Card.Backend.UpdateCardArtDto
      • Payantis.Issuing.Card.Backend.UpdateCardAutoRenewalStatusDto
      • Payantis.Issuing.Card.Backend.UpdateCardAutoRenewalStatusResponseDto
      • Payantis.Issuing.Card.Backend.UpdateCardProductDto
      • Payantis.Issuing.Card.Backend.UpdateCardStatusResponseDto
      • Payantis.Issuing.Card.Backend.UpdateCardStatusResponseDto+IssuanceResultDto
      • Payantis.Issuing.Card.Backend.UpdateCustomerCardStatusRequestDto
      • Payantis.Issuing.Card.Backend.UpdateCustomerCardStatusResponseDto
      • Payantis.Issuing.Card.Backend.UpdateCustomerDto
      • Payantis.Issuing.Card.Backend.UpdateVelocityCheckDto
      • Payantis.Issuing.Card.Backend.VelocityAvailableAmountDto
      • Payantis.Issuing.Card.Backend.VelocityCheckDto
      • Payantis.Issuing.Card.Backend.VelocityControlsDto
      • Payantis.Issuing.Card.Backend.VelocityLimitDto
      • Payantis.Issuing.Card.Backend.VelocityUsedAmountDto
      • Payantis.Issuing.Card.BaseCardDto
      • Payantis.Issuing.Card.BaseCardProductPhysicalDto
      • Payantis.Issuing.Card.BaseLinkDto
      • Payantis.Issuing.Card.CardAnnualFeeDto
      • Payantis.Issuing.Card.CardAnnualFeeLinkDto
      • Payantis.Issuing.Card.CardArtDto
      • Payantis.Issuing.Card.CardDeliveryAddressDto
      • Payantis.Issuing.Card.CardDeliveryCommunicationDto
      • Payantis.Issuing.Card.CardDetailDto
      • Payantis.Issuing.Card.CardDto
      • Payantis.Issuing.Card.CardInfoDto
      • Payantis.Issuing.Card.CardIssuanceFeeDto
      • Payantis.Issuing.Card.CardIssuanceFeeLinkDto
      • Payantis.Issuing.Card.CardParentDto
      • Payantis.Issuing.Card.CardPhysicalSummaryDto
      • Payantis.Issuing.Card.CardPolicyAddRequestDto
      • Payantis.Issuing.Card.CardPolicyDto
      • Payantis.Issuing.Card.CardPolicyResponseDto
      • Payantis.Issuing.Card.CardProductDetailDto
      • Payantis.Issuing.Card.CardProductDto
      • Payantis.Issuing.Card.CardProductGroupDto
      • Payantis.Issuing.Card.CardProductPhysicalDto
      • Payantis.Issuing.Card.CardSummaryDto
      • Payantis.Issuing.Card.ChangePinRequestDto
      • Payantis.Issuing.Card.CreateAuthorizationCheckDto
      • Payantis.Issuing.Card.CreateCardAnnualFeeDto
      • Payantis.Issuing.Card.CreateCardIssuanceFeeDto
      • Payantis.Issuing.Card.CreateCardPolicyDto
      • Payantis.Issuing.Card.CreateCardProductPhysicalDto
      • Payantis.Issuing.Card.CreateTransactionFeeDto
      • Payantis.Issuing.Card.CreateUpdateCustomerSegmentDto
      • Payantis.Issuing.Card.CustomerAddressDto
      • Payantis.Issuing.Card.CustomerCommunicationDto
      • Payantis.Issuing.Card.CustomerDetailDto
      • Payantis.Issuing.Card.CustomerDto
      • Payantis.Issuing.Card.CustomerIdentificationDto
      • Payantis.Issuing.Card.CustomerSegmentDto
      • Payantis.Issuing.Card.Dto.Backend.CardVelocityRequestDto
      • Payantis.Issuing.Card.Dto.CardShipmentDetailResponseDto
      • Payantis.Issuing.Card.Dto.CardShipmentResponseDto
      • Payantis.Issuing.Card.Dto.Cvv2AndResponseDto
      • Payantis.Issuing.Card.IssuanceDetailsDto
      • Payantis.Issuing.Card.IssuanceDto
      • Payantis.Issuing.Card.IssuanceNewCardDto
      • Payantis.Issuing.Card.IssuanceSummaryDto
      • Payantis.Issuing.Card.LinkCustomerDto
      • Payantis.Issuing.Card.MonitoringCustomerCardsDto
      • Payantis.Issuing.Card.NoNameCardRequestDto
      • Payantis.Issuing.Card.TransactionFeeDto
      • Payantis.Issuing.Card.TransactionFeeLinkDto
      • Payantis.Issuing.Card.UnLinkCustomerDto
      • Payantis.Issuing.Card.UpdateAuthorizationCheckDto
      • Payantis.Issuing.Card.UpdateCardAnnualFeeDto
      • Payantis.Issuing.Card.UpdateCardIssuanceFeeDto
      • Payantis.Issuing.Card.UpdateDigitalSlipTypeDto
      • Payantis.Issuing.Card.UpdateDigitalSlipTypeResponseDto
      • Payantis.Issuing.Card.UpdateTransactionFeeDto
      • Payantis.Issuing.Card.UpdatedCardInfo
      • Payantis.Issuing.Card.VelocityCheckLinkDto
      • Payantis.Issuing.Card.VerifCvv2RequestDto
      • Payantis.Issuing.Card.VerifyOrSetPinRequestDto
      • Payantis.Issuing.Dto.CreateCardBulkResponseDto
      • Payantis.Issuing.Integration.PublicKeyDto
      • Payantis.Issuing.IntegrationKeyExchangeResponseDto
      • Payantis.SystemParameter.BaseTenantDetailDto
      • Payantis.SystemParameter.CardBinDto
      • Payantis.SystemParameter.CardBinRangeDto
      • Payantis.SystemParameter.CreateTenantIssuingAttributeDto
      • Payantis.SystemParameter.CreateUpdateCardBinRangeDto
      • Payantis.SystemParameter.CreateUpdateTenantWebHookDto
      • Payantis.SystemParameter.CurrencyExchangeRateDto
      • Payantis.SystemParameter.Dto.AdditionalAmountDto
      • Payantis.SystemParameter.Dto.Request.CreateNoteEntityTypeDto
      • Payantis.SystemParameter.Dto.Response.NoteResponseDto
      • Payantis.SystemParameter.Dto.TaxDto
      • Payantis.SystemParameter.Request.CreateCardBinDto
      • Payantis.SystemParameter.Request.CreateUpdateCurrencyExchangeRateDto
      • Payantis.SystemParameter.Request.UpdateCardBinDto
      • Payantis.SystemParameter.TenantDetailDto
      • Payantis.SystemParameter.TenantIssuingAttributeDto
      • Payantis.SystemParameter.TenantWebHookDto
      • Payantis.SystemParameter.UpdateTenantCurrencyConversionDto
      • Payantis.SystemParameter.UpdateTenantIssuingAttributeDto
      • Payantis.Transaction.Issuing.Backend.CardTransactionResponseDto
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Card.Dto.AuditLogCardListItemDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Card.Dto.AuditLogPolicyListItemDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Card.Dto.AuditLogProductListItemDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Issuing.Card.CardProductDetailDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Issuing.Card.CardProductGroupDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Issuing.Card.CustomerDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Issuing.Card.CustomerSegmentDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Issuing.Card.IssuanceSummaryDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.SystemParameter.CardBinDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.SystemParameter.Dto.Response.NoteResponseDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Transaction.Issuing.Backend.CardTransactionResponseDto>
  • Transaction Testing API
    • Transaction Testing
    • Get Card Info
      POST
    • Generate Pin Block
      POST
    • Extract Clear Pin
      POST
    • Process Transaction
      POST
    • Void Transaction
      POST
    • Refund Transaction
      POST
    • Schemas
      • Payantis.SandBox.BaseSimulationResponseDto
      • Payantis.SandBox.DetailedSimulationRefundRequestDto
      • Payantis.SandBox.DetailedSimulationRefundResponseDto
      • Payantis.SandBox.DetailedSimulationRequestDto
      • Payantis.SandBox.DetailedSimulationResponseDto
      • Payantis.SandBox.DetailedSimulationReversalRequestDto
      • Payantis.SandBox.DetailedSimulationReversalResponseDto
      • Payantis.SandBox.Dto.ClearCardInfoDto
      • Payantis.SandBox.Dto.ClearCardInfoRequestDto
      • Payantis.SandBox.Dto.ClearPinRequestDto
      • Payantis.SandBox.Dto.ClearPinResponseDto
      • Payantis.SandBox.Dto.EncryptCardNumberRequestDto
      • Payantis.SandBox.Dto.PinBlockRequestDto
      • Payantis.SandBox.Dto.PinBlockResponseDto
      • Payantis.SandBox.Dto.PinTestRequestDto
      • Payantis.SandBox.Dto.PinTestResponseDto
      • Payantis.SandBox.SimulationRefundRequestDto
      • Payantis.SandBox.SimulationRefundResponseDto
      • Payantis.SandBox.SimulationRequestDto
      • Payantis.SandBox.SimulationResponseDto
      • Payantis.SandBox.SimulationReversalRequestDto
      • Payantis.SandBox.SimulationReversalResponseDto
      • Payantis.SystemParameter.AdditionalAmountCalculationSource
      • Payantis.SystemParameter.AdditionalAmountType
      • Payantis.SystemParameter.ArqcResultCodes
      • Payantis.SystemParameter.CardBrand
      • Payantis.SystemParameter.CardholderActivatedTerminalLevel
      • Payantis.SystemParameter.CardholderPresence
      • Payantis.SystemParameter.CavvResultCode
      • Payantis.SystemParameter.CvcResultCode
      • Payantis.SystemParameter.Dto.AdditionalAmountDto
      • Payantis.SystemParameter.Dto.TaxDto
      • Payantis.SystemParameter.KeyType
      • Payantis.SystemParameter.LmkType
      • Payantis.SystemParameter.PosEntryMode
      • Payantis.SystemParameter.ResponseCodes
      • Payantis.SystemParameter.SLIChannel
      • Payantis.SystemParameter.SLIUcafStatusCode
      • Payantis.SystemParameter.TerminalPinCapability
      • Payantis.SystemParameter.TerminalType
      • Payantis.SystemParameter.TransactionCode
      • Payantis.SystemParameter.TransactionDomain
      • Payantis.SystemParameter.TransactionFlowCode
      • Payantis.SystemParameter.TransactionNetwork
      • Payantis.SystemParameter.TransactionStatus
  • Acquiring API
    • Merchant
      • /api/v1/acquiring/merchant
      • /api/v1/acquiring/merchant
      • /api/v1/acquiring/merchant/list
      • /api/v1/acquiring/merchant/{code}
      • /api/v1/acquiring/merchant/{code}
      • /api/v1/acquiring/merchant/contacts/upsert
      • /api/v1/acquiring/merchant/identities/upsert
      • /api/v1/acquiring/merchant/addresses/upsert
      • /api/v1/acquiring/merchant/contact/delete
      • /api/v1/acquiring/merchant/identity/delete
      • /api/v1/acquiring/merchant/address/delete
      • /api/v1/acquiring/merchant/get-terminals
      • /api/v1/acquiring/merchant/user-note
      • /api/v1/acquiring/merchant/user-note
    • MerchantTransaction
      • /api/v1/acquiring-transaction/merchant-transaction
    • Terminal
      • /api/v1/acquiring/terminal
      • /api/v1/acquiring/terminal
      • /api/v1/acquiring/terminal/list
      • /api/v1/acquiring/terminal/{terminalCode}
      • /api/v1/acquiring/terminal/{terminalCode}
      • /api/v1/acquiring/terminal/change-terminal-allowed-currencies
    • Batch
      • /api/v1/acquiring/batch
      • /api/v1/acquiring/batch/list
      • /api/v1/acquiring/batch/update-batch-status
    • AuthTemplate
      • /api/v1/acquiring/auth-template
      • /api/v1/acquiring/auth-template/{authTemplateCode}
      • /api/v1/acquiring/auth-template/{authTemplateCode}
      • /api/v1/acquiring/auth-template/{authTemplateCode}
      • /api/v1/acquiring/auth-template/list
    • EodMessageTemplate
      • /api/v1/acquiring/eod-message-template
      • /api/v1/acquiring/eod-message-template/{eodTemplateCode}
      • /api/v1/acquiring/eod-message-template/{eodTemplateCode}
      • /api/v1/acquiring/eod-message-template/{eodTemplateCode}
      • /api/v1/acquiring/eod-message-template/list
    • Schemas
      • Payantis.Acquiring.Merchant.AuthTemplateResponseDto
      • Payantis.Acquiring.Merchant.BatchCurrencySummaryDto
      • Payantis.Acquiring.Merchant.BatchDto
      • Payantis.Acquiring.Merchant.ChangeTerminalAllowedCurrenciesDto
      • Payantis.Acquiring.Merchant.CreateAuthTemplateDto
      • Payantis.Acquiring.Merchant.CreateEodMessageTemplateDto
      • Payantis.Acquiring.Merchant.CreateMerchantAddressDto
      • Payantis.Acquiring.Merchant.CreateMerchantContactDto
      • Payantis.Acquiring.Merchant.CreateMerchantDto
      • Payantis.Acquiring.Merchant.CreateMerchantIdentityDto
      • Payantis.Acquiring.Merchant.CreateTerminalDto
      • Payantis.Acquiring.Merchant.EodMessageTemplateDto
      • Payantis.Acquiring.Merchant.EodMessageTemplateResponseDto
      • Payantis.Acquiring.Merchant.MerchantAddressDto
      • Payantis.Acquiring.Merchant.MerchantBasicDto
      • Payantis.Acquiring.Merchant.MerchantContactDto
      • Payantis.Acquiring.Merchant.MerchantDto
      • Payantis.Acquiring.Merchant.MerchantEcommerceDetailsDto
      • Payantis.Acquiring.Merchant.MerchantIdentityDto
      • Payantis.Acquiring.Merchant.MerchantQrDetailsDto
      • Payantis.Acquiring.Merchant.PhysicalTerminalDeviceDto
      • Payantis.Acquiring.Merchant.TerminalDto
      • Payantis.Acquiring.Merchant.TerminalInfoDto
      • Payantis.Acquiring.Merchant.TerminalResponseDto
      • Payantis.Acquiring.Merchant.UpdateAuthTemplateDto
      • Payantis.Acquiring.Merchant.UpdateBatchStatusDto
      • Payantis.Acquiring.Merchant.UpdateEodMessageTemplateDto
      • Payantis.Acquiring.Merchant.UpdateMerchantDto
      • Payantis.Acquiring.Merchant.UpdateTerminalDto
      • Payantis.Acquiring.Merchant.UpsertMerchantAddressDto
      • Payantis.Acquiring.Merchant.UpsertMerchantContactDto
      • Payantis.Acquiring.Merchant.UpsertMerchantIdentityDto
      • Payantis.SystemParameter.Dto.AdditionalAmountDto
      • Payantis.SystemParameter.Dto.Request.CreateNoteEntityTypeDto
      • Payantis.SystemParameter.Dto.Response.NoteResponseDto
      • Payantis.SystemParameter.Dto.TaxDto
      • Payantis.Transaction.Acquiring.Backend.MerchantTransactionResponseDto
      • Payantis.Transaction.Issuing.Backend.CardTransactionResponseDto
      • Payantis.Transaction.MessageFieldsSummaryDto
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Acquiring.Merchant.AuthTemplateResponseDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Acquiring.Merchant.BatchDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Acquiring.Merchant.EodMessageTemplateResponseDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Acquiring.Merchant.MerchantDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Acquiring.Merchant.TerminalDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.SystemParameter.Dto.Response.NoteResponseDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Transaction.Acquiring.Backend.MerchantTransactionResponseDto>
      • Volo.Abp.Application.Dtos.PagedResultDto<Payantis.Transaction.Issuing.Backend.CardTransactionResponseDto>
  • Settlement
    • Mutabakat Kurgusu
  • Auth API
    • Get Token
    • Refresh Token
Home
Payantis
Home
Payantis
  1. Payantis Platform

API Kullanımı

Kimlik Doğrulama#

Payantis API'lerini çağırabilmek için OAuth2.0 protokolü ile kimlik doğrulaması yapılarak Access Token alınması gerekir. Kimlik doğrulaması sırasında kullanılacak kullanıcı adı ve şifre Payantis ekibi tarafından kurumlar ile özel olarak paylaşılır ve bu bilgiler ile token alınarak ve her isteğin headerındaki Authorization bölümüne eklenir.

Access Token Oluşturma ve API Çağrıları#

Token Parametreleri
ParametreDeğeri
grant_typepassword
scopeprofile
client_idIntegration_API_Client
user_namePayantis tarafından verilen API kullanıcı adı
passwordPayantis tarafından verilen API şifresi
Token almak için Get Token methodu kullanılabilir.
Header Bilgilerinin Eklenmesi
API çağrılarında gerekli yetkilendirmeyi sağlamak için alınan token, her isteğin Authorization başlığına şu şekilde eklenir:
Authorization: Bearer token
Token Refresh
Test ortamında tokenlar 2 saat için geçerli olacak şekilde üretilir. Token'ın daha uzun süre kullanılması için bu süre bitiminden önce kullanıcı ve şifre verilmeden refresh token kullanılarak yeniden token alınması gerekir. Böylelikle bir token en fazla 24 saat kullanılabilir. 24 saatin sonunda mutlaka yeni bir token alınması gereklidir. Token Refresh için Refresh Token methodu kullanılabilir.

.NET Kod Örneği: Access Token Alma#

Aşağıdaki kod örneğinde, kullanıcı adı ve şifre bilgileriyle bir erişim token'ı alınmaktadır.

Idempotency ve Correlation ID#

Platform API'lerini çağıran client'ların her API çağrısı için unique bir Correlation ID göndermesi beklenmektedir.
Payantis Platform'da idempotency, istemciden gelen her isteğe özel bir correlation-id gönderilerek sağlanır. Sistem, aynı correlation id ile yapılan tekrar eden istekleri algılar ve sadece ilkini işleyerek yinelenen işlemleri engeller.
Kurum servis çağrılarında her isteğe özel atanan correlation-id ile:
İstek akışı izlenir, hangi servislerin çağrıldığı ve nasıl işlendiği görülür.
Hata ayıklama süreci hızlanır, belirli bir isteğe bağlı hatalar daha kolay tespit edilir.
Günlük (log) analizi daha verimli hale gelir, tüm işlem zinciri uçtan uca takip edilir.

Request Dili#

API çağrılarında header'da Accept-Language gönderilmesi tavsiye edilmektedir. Response mesajlarındaki cevap ve hata açıklamaları burada gönderilen dile göre oluşturulmaktadır. Öte yandan küçük-büyük harf dönüşümleri (Örneğin requestte gönderilen müşteri adı/soyadı gibi alanlar kaydedilirken büyük harfe dönüştürülmektedir) de Accept-Language alanında belirtilen dile göre yapılmaktadır.

Hassas Bilgilerin Güvenli İletimi#

PCI-DSS gereği ödeme sistemlerinde hassas verilerin güvenli iletimi çok önemlidir. Bu veriler; açık kart numarası, CVV, son kullanma tarihi ve PIN'dir. Payantis Platform'da kurumdan gelen ve kuruma gönderilen bu tür bilgiler şifrelenerek iletilir. Şifreleme şu durumlarda yapılır:
Kurumun Verileri Şifrelemesi: Kurum, bazı durumlarda açık kart numarası ile işlem yapmak isteyebilir. Payantis, bu numarayı şifrelemek için 2048 bit uzunluğunda bir RSA anahtar çifti üretir ve public anahtarını kuruma verir. Kurum, bu public anahtarla veriyi şifreler. Payantis, gelen veriyi kendi private anahtarıyla çözüp işleme alır.
Payantisin Verileri Şifrelemesi: Payantis, hassas verileri sistemde açık bir şekilde tutmaz. Ancak bazı durumlarda (örneğin sanal kart bilgilerini göstermek gibi), bu verilerin kuruma açılabilir şekilde iletilmesi gerekir. Kurum bu amaçla 2048 bit uzunluğunda bir RSA anahtar çifti üretir ve public kısmını Payantis’e verir. Payantis bu anahtarla verileri şifreler, kurum ise gelen veriyi kendi private anahtarıyla çözer.
Fiziksel Kart Şifresi Taşıma: Fiziksel kart şifresi değiştirileceğinde (kurumun kanallarından), şifre bilgisinin Payantis’e güvenli şekilde iletilmesi gerekir. Payantis, bu işlem için bir 3DES anahtarı üretir ve kuruma verir, kurum bu anahtarı güvenli bir şekilde saklar. Bu anahtarın kuruma iletilmesi özel bir protokolle güvenli bir şekilde gerçekleştirilir, bunun için Payantis ekibi ile Kurum ekipleri birlikte anahtar seramonisi gerçekleştirirler. Kurum kart şifresini ISO Format 0'a göre formatlar ve bu 3DES anahtarı ile şifreleyerek bir Pin Block oluşturur, kart şifre bilgisi olarak bu Pin Block kullanılır. Payantis herhangi bir şekilde bir kartın şifre bilgisini açığa çıkarmaz ve kuruma herhangi bir formatta iletmez.

Şifreleme İşlemlerinin Uygulanması#

RSA Algoritması İle Veri Şifreleme
Kurumun Payantis Platform'a hassas veriyi gönderebilmesi için aşağıdaki EncryptData methodu ile şifrelemesi gerekmektedir. Bu methodda şifreleme için kullanılacak anahtar olan publicKey Payantis tarafından üretilerek Kuruma iletilmektedir.
RSA Algoritması İle Veri Çözme
Kurumun Payantis'ten gelen hassas ve şifreli veriyi gönderebilmesi için aşağıdaki DecryptData methodu kullanılabilir. Bu methodda veriyi çözme için kullanılacak anahtar olan privateKey kurum tarafından daha önce üretilmiştir.
3DES Algoritması ile PIN'in Şifrelenmesi
Kurumun PIN bilgisini Payantis'e iletebilmesi için şifrelemesi gerekmektedir. Bu şifreleme işleminde kullanılacak anahtar Payantis tarafından kuruma iletilir. Aşağıdaki GeneratePinBlock methodu ile PIN'i şifreli pin block'a çevirmek mümkündür.

Previous
Payantis Platform
Next
Temel Kavramlar
Built with