Payment Invoice: Overview¶
There are three types of incoming transactions that occur in PayCore.io®:
A Payment is a low-level operation that initiates a financial transaction in the defined payment provider using the specified payment method, it simply provides communication with an external provider and the mapping of statuses.
A Payment Request is an operation with rich functionality that initiates one or many payments depending on the conditions set in the routing and exchange rate schemes.
A Payment Invoice is a high-level operation that initiates accompanying Payment Request and Ledger account transactions.
The Payment Invoice includes information on the
exchange rate and other properties.
The full list of properties can be found in the API Reference launch .
Below is a description of each status:
|created||No||No||Initial status after a Payment Invoice is created, processing has not started. |
If PayCore.io® will not return response 201 (Created) HTTP status code on your request, you should consider that the payment invoice was failed to be created
|expired||Yes||No||Means the Payment Invoice hit the lifetime limit (configurable in the 'Invoice lifetime' property) without being successfully processed, but also did not either cancelled or terminated, e.g. your customer has abandoned the payment|
|terminated||Yes||No||Means that the payment process was terminated by a payer prior to the payment invoice lifetime limit|
|processing||No||Yes||Signifies that the payment invoice is processing by PayCore.io® but its processing is not finished and there will be further status updates|
|process_pending||No||Yes||Means that the result of the payment process still being unknown and may not be known for an extended period of time|
|processed||No||No||Confirms the payment has been processed successfully. |
This isn't a final status since the payment can be refunded for different reasons
|partially_processed||No||No||Means that the amount paid is less than the payment invoice amount and that amount is successfully processed, e.g. your customer has entered an amount less than the invoice amount while making an online payment|
|process_failed||Yes||No||Signifies that the Payment Invoice processing has failed, may be set when an error occurs and the corresponding payment request has failed. |
This status is considered final due to the maximum number of attempts has been reached (default – 5 attempts)
|refunding||No||Yes||Means the payment invoice is refunding and the result of the payment invoice refunding still being unknown|
|refund_pending||No||Yes||Means that the result of the payment refunding still being unknown and may not be known for an extended period of time|
|partially_refunded||Yes||No||Means that the amount refunded is less than the payment invoice amount and that amount is successfully refunded.|
|refunded||Yes||No||Means the payment invoice is successfully refunded in full|
|refund_failed||Yes||No||Means that the payment invoice refunding has been failed or cannot be completed|