Bulk Payment File Information

File information used within the scope of bulk payments

📁 File Types

ID	Status
1	XLSX Yakında Commin
2	CSV Yakında
3	JSON Yakında
4	XML Yakında
5	TXT

📁 File Patterns

ID	Status
1	Open Card - Simple
2	Open Card - Advanced
3	Insurance - Simple
4	Insurance - Advanced

📁 File Columns

TXT

Open Card Simple:

{cardNumber},{expiryDate},{amount},{lineNumber},{cardOwnerName},{trackingCode},{customerId},{productCategory},{productId},{merchantUniqueCode},{providerBased},{providerKey},{routeGroupKey},{payRouteByPass},{payRouteType},{posBased},{posId}

Open Card Simple - Column Descriptions

Parameter	Description
cardNumber	Card number to be charged
expiryDate	Card expiration date
amount	Payment basket amount
lineNumber	Transaction row number
cardOwnerName	Cardholder name
trackingCode	Tracking Number Note Not unique
customerId	Customer identity number in your system * Can be left empty
productCategory	Product category * Can be left empty
productId	Product ID * Can be left empty
merchantUniqueCode	Must be the same value as MerchantUniqueCode sent in the payment initiation request This code is a unique value assigned by you for the transaction It is used to uniquely identify and track a payment across all operations such as Cancellation Refund and Payment Inquiry * 250 characters * Must be unique
providerBased	Used when you decide on your own side which provider the payment should be routed through
providerKey	Provider key you want the payment to be processed through
routeGroupKey	Used when you want the payment to go through a configured custom provider set The key of the relevant provider set must be provided
payRouteByPass	Send true when you want to bypass the PayRoute configuration defined in the Paywall panel for the specific payment
payRouteType	In the PayRoute bypass process, this field specifies which PayRoute type the settings should be forced to use See: PayRoute Types
posBased	Used when you decide on your own side which provider the payment should be routed through
posId	It is the connection ID of the provider you want the payment to be processed through It is available in the list of connected providers in the Paywall panel

Insurance Simple:

{cardNoFirst},{cardNoLast},{identityNumber},{amount},{lineNumber},{cardOwnerName},{trackingCode},{customerId},{productCategory},{productId},{merchantUniqueCode},{providerBased},{providerKey},{routeGroupKey},{payRouteByPass},{payRouteType},{posBased},{posId}

Insurance Simple - Column Descriptions

Parameter	Description
cardNoFirst	First 8 digits of the card
cardNoLast	Last 4 digits of the card
identityNumber	Cardholder’s TCKN/VKN number
amount	Payment basket amount
lineNumber	Transaction row number
cardOwnerName	Cardholder name
trackingCode	Tracking Number Note: Not unique
customerId	Customer identity number in your system * Can be left empty
productCategory	Product category * Can be left empty
productId	Product ID * Can be left empty
merchantUniqueCode	Must be the same value as MerchantUniqueCode sent in the payment initiation request This code is a unique value assigned by you for the transaction It is used to uniquely identify and track a payment across all operations such as cancellation refund and payment inquiry * 250 characters * Must be unique
providerBased	Used when you decide on your own side which provider the payment should be routed through
providerKey	Provider key you want the payment to be processed through
routeGroupKey	Used when you want the payment to go through a configured custom provider set The key of the relevant provider set must be provided
payRouteByPass	Send true when you want to bypass the PayRoute configuration defined in the Paywall panel for the specific payment
payRouteType	In the PayRoute bypass process, this field specifies which PayRoute type the configuration should be forced to use See: PayRoute Types
posBased	Used when you decide on your own side which provider the payment should be routed through
posId	It is the connection ID of the provider you want the payment to be processed through It is available in the list of connected providers in the Paywall panel

XLSX

CSV

JSON

XML

📁 File Samples

TXT

1KB

acikkart_basic.txt

Open

1KB

sigortacilik_basic.txt

Open

XLSX

CSV

JSON

XML