Finansz
  1. Payment
Finansz
  • PosService API
    • POS API Overview
    • Bin
      • /api/pos/bins
    • Installment
      • /api/pos/installments
    • InstallmentRouting
      • /api/pos/installment-routing
      • /api/pos/installment-routing
    • Link
      • /api/pos/links
      • /api/pos/links
      • /api/pos/links/{id}
      • /api/pos/links/{id}
      • /api/pos/links/{id}
      • /api/pos/links/token
      • /api/pos/links/{id}/payment/non-secure
      • /api/pos/links/{id}/bin
      • /api/pos/links/{id}/installments
      • /api/pos/links/{id}/payment/3d/init
      • /api/pos/links/{id}/payment/3d/complete
    • Merchant
      • /api/pos/merchants
      • /api/pos/merchants
      • /api/pos/merchants/current-tenant-merchant
      • /api/pos/merchants/{id}
      • /api/pos/merchants/{id}
      • /api/pos/merchants/{id}
      • /api/pos/merchants/{merchantId}/documents/{merchantApplicationDocumentId}
      • /api/pos/merchants/{merchantId}/documents/{documentId}
      • /api/pos/merchants/{merchantId}/documents/{documentId}/status
      • /api/pos/merchants/{merchantId}/submit-for-review
      • /api/pos/merchants/{merchantId}/status
    • MerchantApplicationDocument
      • /api/pos/merchant-application-documents
      • /api/pos/merchant-application-documents
      • /api/pos/merchant-application-documents/{id}
      • /api/pos/merchant-application-documents/{id}
      • /api/pos/merchant-application-documents/{id}
    • MerchantCategoryCode
      • /api/pos/merchant-category-codes
      • /api/pos/merchant-category-codes
      • /api/pos/merchant-category-codes/{id}
      • /api/pos/merchant-category-codes/{id}
      • /api/pos/merchant-category-codes/{id}
    • Payment
      • Ödeme İşlemlerini Listeler
        GET
      • Yeni Ödeme İşlemi Oluşturur
        POST
      • Ödeme İşlemi Detayını Getirir
        GET
      • Siparişe Ait Ödeme İşlemlerini Listeler
        GET
      • 2D Ödeme İşlemi Oluşturur
        POST
      • Ödeme İşlemi İçin İptal Başlatır
        POST
      • Ödeme İşlemi İçin İade Başlatır
        POST
      • POS Gün Sonu İşlemini Başlatır
        POST
      • Ödeme İşlemini Sorgular
        GET
    • PosSettings
      • /api/pos/settings/terminals/provider-configuration
      • /api/pos/settings/terminals/provider-configuration
    • Terminal
      • /api/pos/terminals
      • /api/pos/terminals
      • /api/pos/terminals/{id}
      • /api/pos/terminals/{id}
      • /api/pos/terminals/{id}
    • ThreeDInit
      • 3D Secure Ödeme İşlemini Başlatır
      • 3D Secure Ödeme İşlemlerini Listeler
      • 3D Secure Ödeme İşlem Detayını Getirir
    • ThreeDInitIntegration
      • /integration-api/pos/three-dInit/complete
    • Schemas
      • FinansZ.PosService.Entities.InstallmentRouting.InstallmentRoutingType
      • FinansZ.PosService.Entities.Links.CommissionBy
      • FinansZ.PosService.Entities.Links.LinkStatus
      • FinansZ.PosService.Entities.Links.LinkType
      • FinansZ.PosService.Entities.Merchants.CompanyType
      • FinansZ.PosService.Entities.Merchants.MerchantDocumentStatus
      • FinansZ.PosService.Entities.Merchants.MerchantStatus
      • FinansZ.PosService.Entities.Payments.CardType
      • FinansZ.PosService.Entities.Payments.PaymentAction
      • FinansZ.PosService.Entities.Payments.PaymentSource
      • FinansZ.PosService.Entities.Payments.PaymentStatus
      • FinansZ.PosService.Entities.Payments.PaymentType
      • FinansZ.PosService.Entities.Payments.RefundActionType
      • FinansZ.PosService.Entities.Payments.RefundDestinationType
      • FinansZ.PosService.Entities.Payments.RefundStatus
      • FinansZ.PosService.Entities.Payments.ReverseReason
      • FinansZ.PosService.Entities.Payments.ReverseStatus
      • FinansZ.PosService.Entities.Terminals.TerminalProvider
      • FinansZ.PosService.Entities.Terminals.TerminalStatus
      • FinansZ.PosService.Entities.ThreeDInits.ThreeDInitStatus
      • FinansZ.PosService.Providers.Models.BinInformationOutputModel
      • FinansZ.PosService.Providers.Models.CardInstallmentInfo
      • FinansZ.PosService.Providers.Models.GetInstallmentOutputModel
      • FinansZ.PosService.Providers.Models.InstallmentInfo
      • FinansZ.PosService.Services.InstallmentRouting.Dtos.InstallmentRoutingProfileDto
      • FinansZ.PosService.Services.InstallmentRouting.Dtos.InstallmentRoutingRuleDto
      • FinansZ.PosService.Services.InstallmentRouting.Dtos.UpdateInstallmentRoutingProfileDto
      • FinansZ.PosService.Services.InstallmentRouting.Dtos.UpdateInstallmentRoutingRuleDto
      • FinansZ.PosService.Services.Links.Dtos.CompletePublicLinkPaymentDto
      • FinansZ.PosService.Services.Links.Dtos.InitPublicLink3DDto
      • FinansZ.PosService.Services.Links.Dtos.LinkBinRequestDto
      • FinansZ.PosService.Services.Links.Dtos.LinkCreateDto
      • FinansZ.PosService.Services.Links.Dtos.LinkDto
      • FinansZ.PosService.Services.Links.Dtos.LinkInstallmentRequestDto
      • FinansZ.PosService.Services.Links.Dtos.LinkUpdateDto
      • FinansZ.PosService.Services.Links.Dtos.PublicLinkDto
      • FinansZ.PosService.Services.MerchantApplicationDocuments.Dtos.MerchantApplicationDocumentCreateDto
      • FinansZ.PosService.Services.MerchantApplicationDocuments.Dtos.MerchantApplicationDocumentDto
      • FinansZ.PosService.Services.MerchantApplicationDocuments.Dtos.MerchantApplicationDocumentUpdateDto
      • FinansZ.PosService.Services.MerchantCategoryCodes.Dtos.MerchantCategoryCodeCreateDto
      • FinansZ.PosService.Services.MerchantCategoryCodes.Dtos.MerchantCategoryCodeDto
      • FinansZ.PosService.Services.MerchantCategoryCodes.Dtos.MerchantCategoryCodeUpdateDto
      • FinansZ.PosService.Services.Merchants.Dtos.AddressDto
      • FinansZ.PosService.Services.Merchants.Dtos.AuthorizedPersonCreateDto
      • FinansZ.PosService.Services.Merchants.Dtos.AuthorizedPersonDto
      • FinansZ.PosService.Services.Merchants.Dtos.AuthorizedPersonUpsertDto
      • FinansZ.PosService.Services.Merchants.Dtos.MerchantCreateDto
      • FinansZ.PosService.Services.Merchants.Dtos.MerchantDocumentDto
      • FinansZ.PosService.Services.Merchants.Dtos.MerchantDto
      • FinansZ.PosService.Services.Merchants.Dtos.MerchantUpdateDto
      • FinansZ.PosService.Services.Merchants.Dtos.UpdateMerchantDocumentStatusInput
      • FinansZ.PosService.Services.Merchants.Dtos.UpdateMerchantStatusInput
      • FinansZ.PosService.Services.Payments.Dtos.BatchCloseDto
      • FinansZ.PosService.Services.Payments.Dtos.BatchClosePaymentDto
      • FinansZ.PosService.Services.Payments.Dtos.CreateNonSecurePaymentDto
      • FinansZ.PosService.Services.Payments.Dtos.CreatePaymentDto
      • FinansZ.PosService.Services.Payments.Dtos.InquiryDto
      • FinansZ.PosService.Services.Payments.Dtos.PaymentDto
      • FinansZ.PosService.Services.Payments.Dtos.ProvisionList
      • FinansZ.PosService.Services.Payments.Dtos.RefundDto
      • FinansZ.PosService.Services.Payments.Dtos.RefundPaymentDto
      • FinansZ.PosService.Services.Payments.Dtos.ReverseDto
      • FinansZ.PosService.Services.Payments.Dtos.ReversePaymentDto
      • FinansZ.PosService.Services.Settings.TerminalProviderSettingsDto
      • FinansZ.PosService.Services.Terminals.Dtos.TerminalCreateDto
      • FinansZ.PosService.Services.Terminals.Dtos.TerminalDto
      • FinansZ.PosService.Services.Terminals.Dtos.TerminalSettingsDto
      • FinansZ.PosService.Services.Terminals.Dtos.TerminalUpdateDto
      • FinansZ.PosService.Services.ThreeDInits.Dtos.CompleteThreeDInitDto
      • FinansZ.PosService.Services.ThreeDInits.Dtos.CreateThreeDInitDto
      • FinansZ.PosService.Services.ThreeDInits.Dtos.ThreeDInitDto
      • FinansZ.PosService.Services.ThreeDInits.Dtos.ThreeDInitSessionDto
      • Volo.Abp.Application.Dtos.PagedResultDto`1[[FinansZ.PosService.Services.Links.Dtos.LinkDto, FinansZ.PosService.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
      • Volo.Abp.Application.Dtos.PagedResultDto`1[[FinansZ.PosService.Services.MerchantApplicationDocuments.Dtos.MerchantApplicationDocumentDto, FinansZ.PosService.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
      • Volo.Abp.Application.Dtos.PagedResultDto`1[[FinansZ.PosService.Services.MerchantCategoryCodes.Dtos.MerchantCategoryCodeDto, FinansZ.PosService.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
      • Volo.Abp.Application.Dtos.PagedResultDto`1[[FinansZ.PosService.Services.Merchants.Dtos.MerchantDto, FinansZ.PosService.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
      • Volo.Abp.Application.Dtos.PagedResultDto`1[[FinansZ.PosService.Services.Payments.Dtos.PaymentDto, FinansZ.PosService.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
      • Volo.Abp.Application.Dtos.PagedResultDto`1[[FinansZ.PosService.Services.Terminals.Dtos.TerminalDto, FinansZ.PosService.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
      • Volo.Abp.Application.Dtos.PagedResultDto`1[[FinansZ.PosService.Services.ThreeDInits.Dtos.ThreeDInitDto, FinansZ.PosService.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ApplicationAuthConfigurationDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ApplicationConfigurationDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ApplicationFeatureConfigurationDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ApplicationGlobalFeatureConfigurationDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ApplicationLocalizationConfigurationDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ApplicationLocalizationDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ApplicationLocalizationResourceDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ApplicationSettingConfigurationDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ClockDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.CurrentCultureDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.CurrentUserDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.DateTimeFormatDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.IanaTimeZone
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.EntityExtensionDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionEnumDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionEnumFieldDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyApiCreateDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyApiDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyApiGetDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyApiUpdateDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyAttributeDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyFeaturePolicyDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyGlobalFeaturePolicyDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyPermissionPolicyDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyPolicyDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyUiDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyUiFormDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyUiLookupDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ExtensionPropertyUiTableDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.LocalizableStringDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ModuleExtensionDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.ObjectExtending.ObjectExtensionsDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.TimeZone
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.TimingDto
      • Volo.Abp.AspNetCore.Mvc.ApplicationConfigurations.WindowsTimeZone
      • Volo.Abp.AspNetCore.Mvc.MultiTenancy.CurrentTenantDto
      • Volo.Abp.AspNetCore.Mvc.MultiTenancy.FindTenantResultDto
      • Volo.Abp.AspNetCore.Mvc.MultiTenancy.MultiTenancyInfoDto
      • Volo.Abp.Http.Modeling.ActionApiDescriptionModel
      • Volo.Abp.Http.Modeling.ApplicationApiDescriptionModel
      • Volo.Abp.Http.Modeling.ControllerApiDescriptionModel
      • Volo.Abp.Http.Modeling.ControllerInterfaceApiDescriptionModel
      • Volo.Abp.Http.Modeling.InterfaceMethodApiDescriptionModel
      • Volo.Abp.Http.Modeling.MethodParameterApiDescriptionModel
      • Volo.Abp.Http.Modeling.ModuleApiDescriptionModel
      • Volo.Abp.Http.Modeling.ParameterApiDescriptionModel
      • Volo.Abp.Http.Modeling.PropertyApiDescriptionModel
      • Volo.Abp.Http.Modeling.ReturnValueApiDescriptionModel
      • Volo.Abp.Http.Modeling.TypeApiDescriptionModel
      • Volo.Abp.Http.RemoteServiceErrorInfo
      • Volo.Abp.Http.RemoteServiceErrorResponse
      • Volo.Abp.Http.RemoteServiceValidationErrorInfo
      • Volo.Abp.Localization.LanguageInfo
      • Volo.Abp.NameValue
  1. Payment

Yeni Ödeme İşlemi Oluşturur

POST
/api/pos/payments

Request

Authorization
OAuth 2.0
Authorization Code
Add the parameter
Authorization
to Headers，whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Authorize URL: http://localhost:44365/connect/authorize
Token URL: http://localhost:44365/connect/token
or
Body Params application/json

Examples

Responses

🟢200
application/json
OK
Body

🟠400
🟠401
🟠403
🟠404
🔴500
🔴501
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test.web.gw.finansz.com//api/pos/payments' \
--header 'Content-Type: application/json' \
--data-raw '{
    "terminalId": "57e69e1b-2c00-4a26-b5e3-44617c6cc659",
    "amount": 0,
    "currencyCode": 0,
    "action": "string",
    "orderId": "string",
    "installmentCount": 0,
    "maskedCardNumber": "string"
}'
Response Response Example
200 - Example 1
{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "tenantId": "f97df110-f4de-492e-8849-4a6af68026b0",
    "merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b",
    "terminalId": "57e69e1b-2c00-4a26-b5e3-44617c6cc659",
    "transactionDate": "2019-08-24T14:15:22.123Z",
    "amount": 0,
    "refundTotalAmount": 0,
    "currencyCode": 0,
    "orderId": "string",
    "terminalProvider": 1,
    "action": 1,
    "paymentType": 1,
    "paymentSource": 1,
    "paymentStatus": 1,
    "isThreeDs": true,
    "installmentCount": 0,
    "retryCount": 0,
    "threeDInitId": "085933ad-7ddf-4976-9586-c3f8183d58bd",
    "invoiceId": "string",
    "rrn": "string",
    "provisionNumber": "string",
    "authCode": "string",
    "paymentDescription": "string",
    "merchantCommissionRate": 0,
    "merchantCommissionRateAmount": 0,
    "bankCommissionRate": 0,
    "bankCommissionRateAmount": 0,
    "errorCode": "string",
    "errorDescription": "string",
    "mdStatus": "string",
    "maskedCardNumber": "string",
    "cardBrand": "string",
    "cardHolderName": "string",
    "cardType": 1,
    "canReverse": true,
    "concurrencyStamp": "string"
}
Modified at 2026-03-04 21:33:16
Previous
Ödeme İşlemlerini Listeler
Next
Ödeme İşlemi Detayını Getirir
Built with