Skip to main content
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.
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.
Sin un valor reconocible, el riel queda en unknown. Ver Rieles de pago 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. 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.