Guides

Introduction

Card is one of the payment methods available in the create payment service.


Status

StatusReasonDescription
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.
FailedRejectedThe transaction was declined. The acquirer does not allow this transaction to be processed.
FailedInsufficientFundsThe transaction was declined because the card has insufficient Funds.
Please, try a different card.
FailedInvalidCardThe transaction was declined because the card details are invalid. Please, try again.
FailedReferredThe transaction was declined. The customer should contact their bank.
FailedExpiredCardThe transaction was declined because the card is expired.Please, try a different card.
FailedInvalidConfigurationThe transaction was declined due to a processing error. Contact koin for more details
FailedUndefinedThe transaction was declined due to an unexpected error.
FailedStolenCardThe transaction was declined because the card is reported as stolen, related to fraud. Please, try a different card.
FailedConnection RejectedThe transaction was declined due to a processing error. The acquirer and supplier are working on it.
FailedInvalidDataThe 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.

AmountResponse statusStatus changeResponse reason
Amount <= 5.000AuthorizedCollected
5.001 - 10.000AuthorizedFailedChannelRejected
10.001 - 15.000AuthorizedFailedInsufficientFunds
15.001 - 20.000AuthorizedFailedInvalidCard
20.001 - 25.000AuthorizedFailedInvalidData
25.001 - 30.000AuthorizedFailedReferred
30.001 - 35.000AuthorizedFailedExpiredCard
35.001 - 40.000AuthorizedFailedStolenCard
40.001 - 45.000AuthorizedFailedConnectionRefused
45.001 - 50.000AuthorizedFailedInvalidConfiguration
50.001 - 55.000AuthorizedFailedUndefined
56.001 - 57.000ConnectionRefusedFailedReferred
57.001 - 58.000ConnectionRefusedAuthorizedAuthorized
58.001 - 59.990ConnectionRefusedFailedExpiredCard
60.000 - 65.000OpenedAuthorized
65.001 - 70.000UnknownAuthorized
Amount > 150.000AuthorizedCollected