Movimientos Digitales y P2P

Autorizar Movimientos Digitales

El endpoint /core/transactions/v1 te permite autorizar transacciones de entrada y salida de dinero de las cuentas digitales. Revisa el campo result para ver el resultado.
Parámetros disponibles
Header Parameters
X-Idempotency-Keystring(maxLength: 256, minLength: 0)required
Body Parameters
account_idrequired
ID de una cuenta de Pomelo
Ejemplo: acc-23GMRyaPjVbczjGtLfQ6zgUJmLv
typestringrequired
Tipo de la transacción.
Enum: CARD_PURCHASEEXTRACASHCASHOUT_STORECASHOUT_ATMBANK_TRANSFER_INBANK_TRANSFER_OUTCASHINCASHOUTMANUAL_MOVEMENTCLIENT_PAYMENTPAYMENT_INPAYMENT_OUTBILL_PAYMENT_OUTCASHIN_INVOICEARG_TAX_REFUNDARG_TAX_ADJUSTMENT
process_typestringrequired
Sirve para indicar si la transacción se trata de un movimiento original, un reintegro, reversa o un ajuste.
Ejemplo: REFUND
Enum: ORIGINALADJUSTMENTREFUNDREVERSAL
parent_tx_id
ID de una transacción
Ejemplo: atx-23GMkfOa7V1MqUlvEic4Dp7XhTT
dataobjectrequired
entry_typestringrequired
Indica si la transacción quiere ingresar o debitar dinero de una cuenta. Para ingresar dinero se debe usar CREDIT y para debitar DEBIT.
Ejemplo: DEBIT
Enum: CREDITDEBIT
total_amountstring(maxLength: 256, minLength: 0)required
Monto total de la transacción.
Ejemplo: 999.99
process_beforestring(format: date-time)
Este campo es opcional y sirve para indicar una fecha limite para el procesamiento de una transacción. Es útil para flujos asincrónicos.
Detalle de respuestas
idstringrequired
Ejemplo: atx-230ReKOtS2lv0yUi2FKG98ycdXZ
resultstringrequired
Ejemplo: REJECTED
Enum: APPROVEDREJECTED
rejection_reasonstring
Ejemplo: INSUFFICIENT_FUNDS
Enum: INSUFFICIENT_FUNDSACCOUNT_DISABLEDACCOUNT_FROZENMONTHLY_AMOUNT_LIMIT_REACHEDDAILY_AMOUNT_LIMIT_REACHEDCLIENT_MONTHLY_AMOUNT_LIMIT_REACHEDCLIENT_DAILY_AMOUNT_LIMIT_REACHEDBRIDGE_ACCOUNT_MONTHLY_AMOUNT_LIMIT_REACHEDBRIDGE_ACCOUNT_DAILY_AMOUNT_LIMIT_REACHEDMAX_BRIDGE_ACCOUNT_FUNDING_LIMIT_EXCEEDEDPROCESS_TIME_EXPIREDSOURCE_ACCOUNT_TX_REJECTEDDESTINATION_ACCOUNT_TX_REJECTEDPERIOD_AMOUNT_LIMIT_REACHEDFRAUD_SCORING_REJECTEDPARENT_TX_REJECTED
created_atstring(format: date-time)required

¿Te resultó útil esta sección?

POST/core/transactions/v1
{
"account_id":
"acc-23GMRyaPjVbczjGtLfQ6zgUJmLv"
"type":
"CARD_PURCHASE"
"process_type":
"REFUND"
"parent_tx_id":
"atx-23GMkfOa7V1MqUlvEic4Dp7XhTT"
"data":{
"tx_properties":{
...
}
"description":{
...
}
"details":[
...
]
"metadata":
"'{'extra_property_1': 'My value'}"
}
"entry_type":
"DEBIT"
"total_amount":
"999.99"
"process_before":
"2025-04-19T14:05:46.134Z"
}
Ejemplo de respuestas
{
"id":
"atx-230ReKOtS2lv0yUi2FKG98ycdXZ"
"result":
"REJECTED"
"rejection_reason":
"INSUFFICIENT_FUNDS"
"created_at":
"2025-04-19T14:05:46.134Z"
}

Autorizar Transacción P2P

{{El endpoint /core/transactions/v1/p2p te permite autorizar movimientos de terceros (P2P) de entrada y salida de dinero entre dos cuentas de Pomelo. Podrás consultar el resultado de la transacción en el campo result.
Parámetros disponibles
Header Parameters
X-Idempotency-Keystring(maxLength: 256, minLength: 0)required
Body Parameters
source_account_idstringrequired
ID de la cuenta de origen
Ejemplo: acc-23GMRyaPjVbczjGtLfQ6zgUJmLv
destination_account_idstringrequired
ID de la cuenta de destino.
Ejemplo: acc-76SOlsOklsdl92OsldllKzgUVjUu
source_dataobjectrequired
Data de la transacción de destino.
destination_dataobjectrequired
Data de la transacción de destino.
total_amountstringrequired
Monto total de la transacción.
Ejemplo: 1200.15
process_beforestring(format: date-time)
Este campo es opcional y sirve para indicar una fecha limite para el procesamiento de una transacción. Es útil para flujos asincrónicos.
Detalle de respuestas
source_account_txobjectrequired
destination_account_txobjectrequired

¿Te resultó útil esta sección?

POST/core/transactions/v1/p2p
{
"source_account_id":
"acc-23GMRyaPjVbczjGtLfQ6zgUJmLv"
"destination_account_id":
"acc-76SOlsOklsdl92OsldllKzgUVjUu"
"source_data":{
"metadata":
"'{'extra_property_1': 'My value'}"
"description":{
...
}
"details":[
...
]
}
"destination_data":{
"metadata":
"'{'extra_property_1': 'My value'}"
"description":{
...
}
"details":[
...
]
}
"total_amount":
"1200.15"
"process_before":
"2025-04-19T14:05:46.135Z"
}
Ejemplo de respuestas
{
"source_account_tx":{
"id":
"atx-230ReKOtS2lv0yUi2FKG98ycdXZ"
"result":
"REJECTED"
"rejection_reason":
"INSUFFICIENT_FUNDS"
"created_at":
"2025-04-19T14:05:46.136Z"
}
"destination_account_tx":{
"id":
"atx-230ReKOtS2lv0yUi2FKG98ycdXZ"
"result":
"REJECTED"
"rejection_reason":
"INSUFFICIENT_FUNDS"
"created_at":
"2025-04-19T14:05:46.136Z"
}
}

Parámetros disponibles
Header Parameters
X-Idempotency-Keystring(maxLength: 256, minLength: 0)required
Body Parameters
account_idrequired
ID de una cuenta de Pomelo
Ejemplo: acc-23GMRyaPjVbczjGtLfQ6zgUJmLv
originstringrequired
Enum: ARG_TAXESBRA_ACCOUNTS_PAYMENTPAYMENT_PROCESSORCASH_NETWORKSBANK_NETWORKSCLIENTCASH_MANAGEMENT
typestringrequired
Enum: CARD_PURCHASEEXTRACASHCASHOUT_STORECASHOUT_ATMBANK_TRANSFER_INBANK_TRANSFER_OUTCASHINCASHOUTMANUAL_MOVEMENTCLIENT_PAYMENTPAYMENT_INPAYMENT_OUTBILL_PAYMENT_OUTCASHIN_INVOICEARG_TAX_REFUNDARG_TAX_ADJUSTMENT
process_typestringrequired
Enum: ORIGINALADJUSTMENTREFUNDREVERSAL
parent_tx_id
ID de una transacción
Ejemplo: atx-23GMkfOa7V1MqUlvEic4Dp7XhTT
dataobjectrequired
entry_typestringrequired
Enum: CREDITDEBIT
total_amountstringrequired
process_beforestring(format: date-time)
Detalle de respuestas

¿Te resultó útil esta sección?

POST/core/transactions/fraud/v1/internal
{
"account_id":
"acc-23GMRyaPjVbczjGtLfQ6zgUJmLv"
"origin":
"ARG_TAXES"
"type":
"CARD_PURCHASE"
"process_type":
"ORIGINAL"
"parent_tx_id":
"atx-23GMkfOa7V1MqUlvEic4Dp7XhTT"
"data":{
"origin_tx_id":
"string"
"metadata":{}
}
"entry_type":
"CREDIT"
"total_amount":
"string"
"process_before":
"2025-04-19T14:05:46.136Z"
}
Ejemplo de respuestas
"ERROR":{
"message":
"src property must be a valid json object"
}