CreatePayments
Create a single or multiple payment sby submitting the necessary payment details in a raw format. Users will process them within the FinqTreasury platform.
The API receives payment descriptions for validation and creation (if valid). One or more payments can be created at the same time. The API will respond with a list which describes if a payment was created (so it received an id), or a payment had validation errors. Payment validation rules may differ between payment types (automatically detected based on Debtor IBAN, Creditor IBAN, Currency, Country of Creditor).
Input fields:
"paymentRefNumber": "string", //your internal Id for this payment (mandatory)
"amount": 0.00, //amount (mandatory)
"currencyCode": "str", //currency (RON, EUR, USD,…) (mandatory)
"details": "string", //description of payment (mandatory)
"dueDate": "2024-10-01", //date on which the payment is planed for execution (mandatory)
"creditorName": "string", //name of destination person or company (mandatory)
"creditorIban": "string", //destination IBAN (no spaces) (mandatory)
"creditorCurrencyCode": "str", //currency (RON, EUR, USD,…)(optional)
"debtorName": "string", //name of source person or company (mandatory)
"debtorIban": "string", //source IBAN (no spaces) (mandatory)
"debtorCurrencyCode": "str", //currency (RON, EUR, USD,…) (optional)
"creditorCountry": "string", //two letter country code (optional)
"creditorTown": "string", //creditor address – town (optional)
"creditorAddress": "string", //creditor address – street (optional)
"creditorPostcode": "string", //creditor post code (optional)
"creditorContacts": "string", //creditor contacts (optional)
"creditorContactDetails": "string" //creditor contact details (optional)
"taxIDNumber": "string", //payer VAT number (optional)
"creditorTaxIdNumber": "string", //beneficiary VAT number (mandatory for tax payments)
"endToEndId": "string", //should be unique, can be the same as paymentRefNumber (optional)
Response fields:
"paymentRefNumber": "string", //your internal id reflected back
"paymentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", //FinqTreasury id if payment created
"paymentDataValidationStatus": 0 //no errors; multiple error codes possible
"paymentDataValidationBrokenRules":
"rowIndex": 0,
"brokenRules":
"errorCode": 0,
"errorMessage": "string", //English description of error
"paymentFieldSystemName": "string" //Field name
"paymentStatus": 0,//0=NotCreated, 1=Created, 2=InvalidDataError, 3=InternalError
"createdDate": "2024-10-01T19:29:19.665Z" //Timestamp from FinqTreasury server
Header Parameters
A unique identifier for the client application making the request used for authentication and tracking purposes
A secret API key assigned to the client to securely authenticate the request and authorize access to the endpoint
POST
/
1