Introduction
Card is one of the payment methods available in the create payment service.
Status
| Status | Reason | Description |
|---|---|---|
| Opened | - | The order was created and inprogress. |
| Authorized | - | The order was authorized. |
| Collected | - | The order was created and paid for. |
| Cancelled | - | The state of an Opened order that expired or was cancelled by calling cancelation operation. |
| Voided | - | The state of an Authorized order that expired or was voided by calling cancelation operation. |
| Failed | Rejected | The transaction was declined. The acquirer does not allow this transaction to be processed. |
| Failed | InsufficientFunds | The transaction was declined because the card has insufficient funds. Please try a different card. |
| Failed | InvalidCard | The transaction was declined because the card details are invalid. Please try again. |
| Failed | Referred | The transaction was declined. The customer should contact their bank. |
| Failed | ExpiredCard | The transaction was declined because the card is expired. Please try a different card. |
| Failed | InvalidConfiguration | The transaction was declined due to a processing error. Contact Koin for more details. |
| Failed | InvalidPlanConfiguration | The transaction was declined due to missing configuration for this card brand/type/account. Contact Koin for more details. |
| Failed | Undefined | The transaction was declined due to an unexpected error. |
| Failed | StolenCard | The transaction was declined because the card is reported as stolen (fraud). Please try a different card. |
| Failed | ConnectionRefused | The transaction was declined due to a processing error. The acquirer and supplier are working on it. |
| Failed | InvalidData | The transaction was declined due to a processing error. Contact Koin for more details. |
When the order status changes a webhook notification will be sent.
Testing environment mocks
In order to test all scenarios in a testing environment, you can use the order amount to force the order status in the create payment response. For example, if the order amount is less than 5001, the order status will be "Authorized" and after a couple of minutes, it will capture and change to "Collected". In the table below you can find other options.
| Amount | Response status | Status change | Response reason |
|---|---|---|---|
| Amount <= 5.000 | Authorized | Collected | |
| 5.001 – 10.000 | Failed | – | ChannelRejected |
| 10.001 – 15.000 | Failed | – | InsufficientFunds |
| 15.001 – 20.000 | Failed | – | InvalidCard |
| 20.001 – 25.000 | Failed | – | InvalidData |
| 25.001 – 30.000 | Failed | – | Referred |
| 30.001 – 35.000 | Failed | – | ExpiredCard |
| 35.001 – 40.000 | Failed | – | StolenCard |
| 40.001 – 45.000 | Failed | – | ConnectionRefused |
| 45.001 – 50.000 | Failed | – | InvalidConfiguration |
| 50.001 – 55.000 | Failed | – | Undefined |
| 56.001 – 57.000 | Opened | Failed | Referred |
| 57.001 – 58.000 | Opened | Authorized | Authorized |
| Amount > 150.000 | Authorized | Collected |
Updated 7 months ago