POST
/core/transactions/v1Autorizar 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-KeyStringrequired
Cuerpo de solicitud
application/jsonaccount_idstringrequired
typeenumrequired
process_typeenumrequired
parent_tx_idstring
dataobjectrequired4 propiedades
entry_typeenumrequired
total_amountstringrequired
process_beforestring
accounts_idarray
client_idstring
localobject2 propiedades
settlementobject2 propiedades
transactionobject2 propiedades
Autenticación
🔑bearer-keyapiKey
Detalle de respuestas
Ejemplo de solicitud
{
"account_id": "acc-23GMRyaPjVbczjGtLfQ6zgUJmLv",
"type": "CARD_PURCHASE",
"process_type": "REFUND",
"parent_tx_id": "atx-23GMkfOa7V1MqUlvEic4Dp7XhTT",
"data": {
"tx_properties": {
"merchant_id": "13091231029",
"address": "Fake Street 123",
"merchant_name": "Example Store",
"merchant_logo_url": "http://logo-url",
"card_type": "DEBIT",
"point_type": "POS",
"entry_mode": "UNKNOWN",
"last_digits": "1234",
"card_brand": "Visa",
"card_bin": "4344",
"mcc": "5021"
},
"description": {
"es-AR": "Alguna descripción.",
"en-US": "Some description."
},
"details": [
{
"amount": "999.99",
"entry_type": "DEBIT",
"type": "BASE",
"subtype": "example_value",
"description": {
"es-AR": "Alguna descripción.",
"en-US": "Some description."
},
"metadata": "\"{\"extra_property_1\": \"My value\"}"
}
],
"metadata": "\"{\"extra_property_1\": \"My value\"}"
},
"entry_type": "DEBIT",
"total_amount": "999.99",
"process_before": "2026-02-07T01:37:37.278Z",
"accounts_id": [
"example_value"
],
"client_id": "example_value",
"local": {
"total": "example_value",
"currency": "example_value"
},
"settlement": {
"total": "example_value",
"currency": "example_value"
},
"transaction": {
"total": "example_value",
"currency": "example_value"
}
}Ejemplo de código
curl -X POST "https://api.pomelo.la/core/transactions/v1" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Idempotency-Key: example_value" \
-d '{
"account_id": "acc-23GMRyaPjVbczjGtLfQ6zgUJmLv",
"type": "CARD_PURCHASE",
"process_type": "REFUND",
"parent_tx_id": "atx-23GMkfOa7V1MqUlvEic4Dp7XhTT",
"data": {
"tx_properties": {
"merchant_id": "13091231029",
"address": "Fake Street 123",
"merchant_name": "Example Store",
"merchant_logo_url": "http://logo-url",
"card_type": "DEBIT",
"point_type": "POS",
"entry_mode": "UNKNOWN",
"last_digits": "1234",
"card_brand": "Visa",
"card_bin": "4344",
"mcc": "5021"
},
"description": {
"es-AR": "Alguna descripción.",
"en-US": "Some description."
},
"details": [
{
"amount": "999.99",
"entry_type": "DEBIT",
"type": "BASE",
"subtype": "example_value",
"description": {
"es-AR": "Alguna descripción.",
"en-US": "Some description."
},
"metadata": "\"{\"extra_property_1\": \"My value\"}"
}
],
"metadata": "\"{\"extra_property_1\": \"My value\"}"
},
"entry_type": "DEBIT",
"total_amount": "999.99",
"process_before": "2026-02-07T01:37:37.501Z",
"accounts_id": [
"example_value"
],
"client_id": "example_value",
"local": {
"total": "example_value",
"currency": "example_value"
},
"settlement": {
"total": "example_value",
"currency": "example_value"
},
"transaction": {
"total": "example_value",
"currency": "example_value"
}
}'Ejemplo de respuesta (201)Transacción procesada.
{
"id": "atx-230ReKOtS2lv0yUi2FKG98ycdXZ",
"result": "REJECTED",
"rejection_reason": "INSUFFICIENT_FUNDS",
"created_at": "2024-01-01T00:00:00Z",
"balance": "string",
"exchange_data": {
"exchange_rate_id": "string",
"exchange_rate": 0,
"origin_currency": "string",
"origin_amount": 0,
"destination_currency": "string",
"destination_amount": 0,
"account_id": "string"
}
}