> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fraudeg.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Métodos de pago y rieles

> Campo canónico payment_method, alias de wire, y los 8 rieles

El campo canónico que debes enviar es **`payment_method`**. El motor deriva el **riel** de
ese valor: la familia de instrumento que decide qué señales aplican.

Si tu payload ya trae `paymentInstrumentType`, también se acepta: es un **alias de wire**
del mismo campo, no un campo distinto. Envía uno u otro, no hace falta mandar los dos.
FraudEG normaliza a `payment_method`.

<Warning>
  El nombre con el que programas es `payment_method`. `paymentInstrumentType` es un alias
  aceptado del mismo campo, no un campo distinto ni el nombre canónico.
</Warning>

Sin un valor reconocible, el riel queda en `unknown`. Ver
[Rieles de pago](/introduccion/rieles) para el porqué.

## Los 8 rieles

Estos son los rieles que reconoce el motor. `unknown` no es un riel que envías: es el
fallback.

| Riel               | Valores de `payment_method` que caen aquí                                   |
| ------------------ | --------------------------------------------------------------------------- |
| `card`             | `card`, `credit_card`, `debit`, `debit_card`                                |
| `account_transfer` | `account_transfer`, `pse`, `transfer`, `bre-b`, `breb`, `boton_bancolombia` |
| `bnpl_credit`      | `bnpl_credit`, `bnpl`                                                       |
| `crypto`           | `crypto`                                                                    |
| `cash`             | `cash`                                                                      |
| `wallet_balance`   | `wallet_balance`, `wallet`                                                  |
| `qr`               | `qr`                                                                        |
| `payment_link`     | `payment_link`, `link`                                                      |

Cualquier otro string (o un valor que no se pueda reconocer) → riel `unknown`.

## Qué valor enviar

No hay una lista cerrada de “nueve métodos oficiales” aparte de la tabla de arriba. Envía
el valor que mejor describa el instrumento; si coincide con un alias de la tabla, cae en
ese riel.

Recomendación práctica: si no tienes un alias regional (`pse`, `bre-b`,
`boton_bancolombia`, …), envía el **nombre del riel** (`card`, `account_transfer`,
`bnpl_credit`, `crypto`, `cash`, `wallet_balance`, `qr`, `payment_link`).

`card` cubre crédito y débito. `credit_card` y `debit_card` son alias del mismo riel, no
rieles distintos.

## Alias de amount

El monto canónico es `transaction_amount`. También se acepta `total_value_usd` como alias
de wire del mismo número.
