Errors

Every error has the same shape:

{
  "error": {
    "type": "transfer_declined",
    "code": "insufficient_funds",
    "message": "La cuenta acc_01JA2B3C4D5E6F7G8H9JKMNPQR tiene 120000 centavos disponibles y la transferencia necesita 150050.",
    "display_message": "No hay saldo suficiente para esta transferencia.",
    "param": "amount",
    "request_id": "req_01JA2B3C4D5E6F7G8H9JKMNPQT",
    "retryable": false,
    "doc_url": "https://docs.fcmpayments.com/errores#insufficient_funds",
    "transfer_id": "otr_01JA2B3C4D5E6F7G8H9JKMNPQV"
  }
}

message is for the integrator; display_message is a text in Spanish suitable for showing to an end user (or null). retryable: true means: retry the same request with the same Idempotency-Key.

compliance_rejected and risk_rejected are deliberately generic: FCM Payment Solutions S.A.S. does not disclose the details of an anti-money-laundering control (Argentine Law 25,246, duty of non-disclosure). FCM Payment Solutions S.A.S. does keep the full reason.

The error object

• type ErrorType required
• code ErrorCode required

  See the table of codes in the general description.

• message string required

  Technical explanation for the integrator. Do not show it to end users.

• display_message string | null required

  Text in Spanish suitable for showing to an end user, or null.

• param string | null required

  Field or header that caused the error, if applicable.

• request_id RequestId required
• retryable boolean required

  true: retry the same request with the same Idempotency-Key.

• doc_url string (uri) required
• transfer_id OutgoingTransferId | null required

  In a transfer 422, the id of the object that was left in rejected.