Codes de Réponse de l’API

Codes de réponse et statuts des transactions

Cette section fournit les codes de réponse retournés par le système ainsi que les statuts possibles des transactions, avec des explications détaillées pour le champ result.statusReason.

Response Codes

Code	Reason	Description
200	OK	The request was successful.
204	No Content	The request was successful but has no content to return.
400	Bad Request	Some content in the request was invalid.
401	Unauthorized	Authentication is required before making the request.
403	Forbidden	The current user is not allowed to perform this operation.

Transaction Statuses

Status	Description
COMPLETED	The transaction was successful, and the funds have been transferred to the recipient.
FAILED	The transaction failed due to an error, such as insufficient funds or a technical issue.
CANCELED	The transaction was canceled by the user or merchant.
PENDING	The transaction is under review, pending verification of the payment source.
PROCESSING	The transaction is being processed and will be completed shortly.
REFUSED	The payment was refused by the payment processor or the recipient.
REVERSED	The transaction was reversed, either by the merchant or the system.
NEEDS_MERCHANT_VALIDATION	The transaction is awaiting validation from the merchant before it can proceed.

result.statusReason Field

The result.statusReason field provides additional context for the transaction's status, explaining why a particular status was assigned. Here are some examples of possible values and their meanings:

Status	Possible Reasons in result.statusReason
COMPLETED	"Funds successfully transferred"
FAILED	"Insufficient funds", "Invalid account number", "Payment method not supported"
CANCELED	"Canceled by user", "Timeout expired before payment completion"
PENDING	"Verification required", "Awaiting payment processor response"
PROCESSING	"Transaction in progress", "Batch processing scheduled"
REFUSED	"Recipient refused the payment", "Fraud detected by payment processor"
REVERSED	"Transaction reversed by merchant", "Customer requested a chargeback"
NEEDS_MERCHANT_VALIDATION	"Awaiting merchant's manual approval"

Example Response

Here’s an example of a response object with the result.statusReason field:

{
  "id": "63a368858622d5ded108e4b3",
  "result": {
    "status": "FAILED",
    "statusReason": "Insufficient funds"
  }
}