Technical information
Last update: August 3, 2023
Payment report details
The first line of the file is always the same. It provides the name of each column, given that the file is opened with a spreadsheet. Column names can be in French or in English, the language is chosen during the file setting.
The other lines provide details on every transaction. Each line contains one single transaction. The "len" column indicates the maximum length of the field.
A line is divided in three parts:
- Details of purchase (always filled)
- Details of deposit (optional)
- Details of fundings (optional)
Operation of the payment report
Payments
3x 4x Oney
In case of a Oney 3x4x payment, every field is filled.
Paylater
In case of a Oney Paylater payment, only part 1 and part 3 will be filled.
Payments with an Oney Card
These records, where the value in first column is "CA", will have only the two first parts filled.
Funding with an Oney Card
These records will only have part 1 and part 3 filled.
Long-term funding
These records will have all three parts filled.
Commissions
When the subscribed product involves charging commissions, the commissions will be displayed in the payment report.
If you chose the credit transfer/direct debit mode, which means that Oney will allocate the total amount of purchases and will charge the commissions once a month, the debit ID will be displayed in the payment report.
If you chose the clearing mode, which means that Oney will allocate the total amount of purchases net of the commissions amount, the debit ID will not be displayed.
Cancellation of Oney 3x4x
A cancellation can be total or partial, and the information displayed will be different following one case or the other.
Partial cancellation
If the amount of the partial cancellation is lesser than the deferred outstanding amount, only parts 1 and 3 will be filled. In the column Payment_amount_2 the amount taken back to Oney will be displayed, and in column Commission_amount_2 the amount of refunded commissions. Note that the symbols will be reversed compared to a purchase (- symbol for Payment_amount_2 and + symbol for Commissoin_amount_2.)
If the amount of the partial cancellation is greater than the deferred outstanding amount, all three parts will be filled. In the column Payment_amount_2 the amount of the outstanding deferred (that is cancelled) will be displayed, and in the column Commission_amount_2 the amount of refunded commissions. The complement of the refund will be displayed in the column Payment_amount. Again, the symbols will be reversed compared to a purchase.
If the partial cancellation concerns a fully refunded purchase, only parts 1 and 2 will be filled in. We will find in the Payment_amount column the amount taken back to Oney and in the Commission_amount column the commissions reimbursed by Oney. Note that the signs are therefore reversed in relation to a purchase (sign – for Payment_amount and + for Commission_amount).
Total Cancellation
In the case of a total cancellation, the outstanding deferred amount (that is cancelled) will be displayed in the column Payment_amount_2 and the amount of refunded commissions will be in the column Commission_amount_2. The complement of the refund will be displayed in the column Payment_amount. Again, the symbols will be reversed compared to a purchase.
The commission on the deposit is never refunded, therefore the column Commission_amount is to remain void.
Note: when a cancellation occurs during the deferral period of the monthly payment, it will be processed once the debit has occurred. Therefore, there can be a 5-day delay before a cancellation is processed.
Cancellation of other products
Cancellation of other products will be treated the same as the original purchase, therefore the same columns will be filled.
Payment report file
M: Mandatory
O: Optional
General
Field name | Type | Len | Mandatory / Optional | Description |
---|---|---|---|---|
PR_Type | String | 3 | M | CA: Payment with an Oney card FIN: Funding with an Oney card, split payment, paylater REG: Regularization |
IS_cancel | String | 1 | M | Y : Cancellation N : Purchase |
Merchant_guid | String | 100 | M | Global Unique Identifier of the merchant |
PSP_guid | String | 100 | O | Global Unique Identifier of the PSP |
Purchase_date | String | 10 | M | Format : DD/MM/YYYY Unfilled if PR_type = "REG" and IS_cancel = "Y" |
Purchase_hour | String | 6 | M | Format : HHMMSS Unfilled if PR_type = "REG" and IS_cancel = "Y" |
Cancel_date | String | 10 | O | Format : DD/MM/YYYY Unfilled if IS_cancel = "N", Mandatory if IS_cancel = "Y" |
Cancel_hour | String | 6 | O | Format : HHMMSS Unfilled if IS_cancel = "N", Mandatory if IS_cancel = "Y" |
Funding_reference | String | 16 | O | Oney internal reference of the funding |
External_reference | String | 128 | O | Reference of the partner to identify a customer's order Mandatory for split payments |
Transaction_number | String | 50 | O | Oney internal reference of the transaction Mandatory for split payments |
Customer_external_code | String | 128 | O | External reference of the customer Mandatory for split payments |
Total_amount_symbol | String | 1 | M | "+" : purchase "-" : refund |
Total_amount | Number | 15,2 | M | Amount of the transaction (purchase or cancellation) |
Total_amount_currency | String | 3 | M | ISO 4217 Example : "EUR", "GBP" |
Hidden_PAN | String | 19 | M | Primary Account Number used for the payment masked with PCI DSS rules |
Auth_number | Number | 20 | O | Authorization number of the deposit |
Merchant_context | String | 50 | O | Field for merchant internal use |
PSP_context | String | 50 | O | Field for PSP internal use |
Installment_number | Number | 2 | O | Total duration of the credit |
RFU | Reserved for Future Use |
Deposit
Field name | Type | Len | Mandatory / Optional | Description |
---|---|---|---|---|
Commercial_code | String | 5 | O | Used to identify the deposit |
Payment_symbol | String | 1 | O | "+" : purchase "-" : refund |
Payment_amount | Number | 15,2 | O | Amount of the deposit or of the refund |
Tansfer_Id | String | 11 | O | Bank transfer reference |
Due_date | String | 10 | O | Format DD/MM/YYYY Value date on merchant side |
Commission_symbol | String | 1 | O | "-" for a purchase "+" for a refund |
Commission_amount | Number | 15,2 | O | amount of fees associated to the deposit or refund |
Direct_debit_id | String | 11 | O | Bank direct debit Id |
RFU | Reserved for Future Use | |||
RFU | Reserved for Future Use | |||
RFU | Reserved for Future Use |
Funding
Field name | Type | Len | Mandatory / Optional | Description |
---|---|---|---|---|
Commercial_code_2 | String | 5 | O | Used to identify the product (Business transaction code) |
Payment_symbol_2 | String | 1 | O | "+" : purchase "-" : refund |
Payment_amount_2 | Number | 15,2 | O | Amount of the funding or of the refund |
Tansfer_Id_2 | String | 11 | O | Bank transfer reference |
Due_date_2 | String | 10 | O | Format DD/MM/YYYY Value date on merchant side |
Commission_symbol_2 | String | 1 | O | "-" for a purchase "+" for a refund |
Commission_amount_2 | Number | 15,2 | O | amount of fees associated to the funding or refund |
Direct_debit_id_2 | String | 11 | O | Bank direct debit Id |
RFU | Reserved for Future Use | |||
RFU | Reserved for Future Use | |||
RFU | Reserved for Future Use |