Crear transferencia interna entre billeteras propias

POST 
/api/withdrawal/internal-own

Crea una transferencia interna entre billeteras del comercio y devuelve la transacción creada.

Solicitud

application/json

Body

Cuerpo de la solicitudobligatorio

Datos para crear una transferencia interna entre billeteras propias.

srcWalletIdstringnullable
ID de la billetera de origen.
Ejemplo: USD880390848110
amountnumberobligatorio
Monto.
Valores posibles: >= 0
Ejemplo: 10.25
actionstringobligatorio
Acción.
Valores posibles: [GIVE, GET]
Ejemplo: GIVE
notestringnullable
Nota.
Valores posibles: <= 255 caracteres
Ejemplo: Sandbox transfer note
srcCurrencystringnullable
Moneda de origen.
Valores posibles: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Ejemplo: USD
destWalletIdstringnullable
ID de la billetera de destino.
Ejemplo: USD880390848110
destCurrencystringnullable
Moneda de destino.
Valores posibles: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Ejemplo: USD

Ejemplo

{
  "srcWalletId": "USD880390848110",
  "amount": 10.25,
  "action": "GIVE",
  "note": "Sandbox transfer note",
  "srcCurrency": "USD",
  "destWalletId": "USD880390848110",
  "destCurrency": "USD"
}

Respuestas

200

OK

application/json

Esquema

Esquema

transactionIduuid
ID de la transacción.
Ejemplo: 11111111-1111-4111-8111-111111111111
paymentMethodTypestring
Tipo de método de pago.
Valores posibles: [INTERNAL_OWN]
Ejemplo: INTERNAL_OWN
transactionTypestring
Tipo de transacción.
Valores posibles: [INTERNAL_TRANSFER_OWN]
Ejemplo: INTERNAL_TRANSFER_OWN
statusstring
Estado.
Valores posibles: [PENDING, COMPLETED, CANCELED, REFUNDED]
Ejemplo: COMPLETED
directionstring
Dirección del movimiento.
Valores posibles: [DEPOSIT, WITHDRAWAL]
Ejemplo: DEPOSIT
transactionDirectionstring
Dirección de la transacción.
Valores posibles: [INCOMING, OUTGOING, EXCHANGE]
Ejemplo: OUTGOING
currencystring
Moneda.
Valores posibles: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Ejemplo: USD
amountnumber
Monto.
Ejemplo: 10.25
createdAtdate-time

Fecha de creación.

paymentScopestring
Ámbito del pago.
Valores posibles: [MERCHANT_API]
Ejemplo: MERCHANT_API
orderIdstring
ID del pedido.
Ejemplo: ORDER_123456
walletSrcIdstring
ID de la billetera de origen.
Ejemplo: USD880390848110
walletDestIdstring
ID de la billetera de destino.
Ejemplo: USD880390848110
fullCommissionnumber
Comisión total.
Ejemplo: 10.25
commentstring
Comentario.
Ejemplo: Sandbox transfer note
cryptoCurrencyTxHashstring
Hash de la transacción cripto.
Ejemplo: 4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e
completedAtdate-time

Fecha de finalización.

Ejemplo

{
  "transactionId": "11111111-1111-4111-8111-111111111111",
  "paymentMethodType": "INTERNAL_OWN",
  "transactionType": "INTERNAL_TRANSFER_OWN",
  "status": "CREATED",
  "direction": "WITHDRAWAL",
  "transactionDirection": "EXCHANGE",
  "currency": "USD",
  "amount": 10.25,
  "createdAt": "2026-01-15T10:30:00",
  "paymentScope": "MERCHANT_API",
  "orderId": "ORDER_123456",
  "walletSrcId": "USD880390848110",
  "walletDestId": "USD880390848110",
  "fullCommission": 10.25,
  "comment": "Sandbox transfer note",
  "cryptoCurrencyTxHash": "4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e",
  "completedAt": "2026-01-15T10:30:00"
}

400

Solicitud incorrecta. La solicitud tiene un formato incorrecto o contiene parámetros no válidos.

application/json

Esquema

Esquema

statusstringobligatorio
Estado de la respuesta.
Valores posibles: [error]
Ejemplo: error
data objectobligatorio
Datos de la respuesta de error.
errors object[]obligatorio
Lista de errores devueltos para la solicitud.
Array [
errorMessagestringobligatorio
Código de error estable y legible por máquina.
Ejemplo: disabled
errorTypestringobligatorio
Categoría del error.
Ejemplo: FORM
errorIdstringobligatorio
Identificador único y corto del error para soporte y registros.
Ejemplo: errTest1234
errorDescriptionstringobligatorio
Descripción legible del error.
Ejemplo: REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API
errorFieldstringnullable
Campo de la solicitud relacionado con el error, si lo hay.
Ejemplo: null
paramsobject[]obligatorio
Parámetros adicionales del error.
requestParamsobjectobligatorio
Parámetros de la solicitud guardados para diagnóstico.
]

Ejemplo

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "disabled",
        "errorType": "FORM",
        "errorId": "errTest1234",
        "errorDescription": "REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

401

No autorizado. Faltan los encabezados de autenticación del comercio o no son válidos.

application/json

Esquema

Esquema

statusstringobligatorio
Estado de la respuesta.
Valores posibles: [error]
Ejemplo: error
data objectobligatorio
Datos de la respuesta de error.
errors object[]obligatorio
Lista de errores devueltos para la solicitud.
Array [
errorMessagestringobligatorio
Código de error estable y legible por máquina.
Ejemplo: userDoesNotExistException
errorTypestringobligatorio
Categoría del error.
Ejemplo: GENERAL
errorIdstringobligatorio
Identificador único y corto del error para soporte y registros.
Ejemplo: errTest1234
errorDescriptionstringobligatorio
Descripción legible del error.
Ejemplo: NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]
errorFieldstringnullable
Campo de la solicitud relacionado con el error, si lo hay.
Ejemplo: null
paramsobject[]obligatorio
Parámetros adicionales del error.
requestParamsobjectobligatorio
Parámetros de la solicitud guardados para diagnóstico.
]

Ejemplo

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "userDoesNotExistException",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

404

No encontrado. El recurso solicitado no existe.

application/json

Esquema

Esquema

statusstringobligatorio
Estado de la respuesta.
Valores posibles: [error]
Ejemplo: error
data objectobligatorio
Datos de la respuesta de error.
errors object[]obligatorio
Lista de errores devueltos para la solicitud.
Array [
errorMessagestringobligatorio
Código de error estable y legible por máquina.
Ejemplo: resourceNotFound
errorTypestringobligatorio
Categoría del error.
Ejemplo: GENERAL
errorIdstringobligatorio
Identificador único y corto del error para soporte y registros.
Ejemplo: errTest1234
errorDescriptionstringobligatorio
Descripción legible del error.
Ejemplo: Resource not found
errorFieldstringnullable
Campo de la solicitud relacionado con el error, si lo hay.
Ejemplo: null
paramsobject[]obligatorio
Parámetros adicionales del error.
requestParamsobjectobligatorio
Parámetros de la solicitud guardados para diagnóstico.
]

Ejemplo

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "resourceNotFound",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Resource not found",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

500

Error interno del servidor. Error inesperado, contacta al soporte

application/json

Esquema

Esquema

statusstringobligatorio
Estado de la respuesta.
Valores posibles: [error]
Ejemplo: error
data objectobligatorio
Datos de la respuesta de error.
errors object[]obligatorio
Lista de errores devueltos para la solicitud.
Array [
errorMessagestringobligatorio
Código de error estable y legible por máquina.
Ejemplo: internalServerError
errorTypestringobligatorio
Categoría del error.
Ejemplo: GENERAL
errorIdstringobligatorio
Identificador único y corto del error para soporte y registros.
Ejemplo: errTest1234
errorDescriptionstringobligatorio
Descripción legible del error.
Ejemplo: Internal server error
errorFieldstringnullable
Campo de la solicitud relacionado con el error, si lo hay.
Ejemplo: null
paramsobject[]obligatorio
Parámetros adicionales del error.
requestParamsobjectobligatorio
Parámetros de la solicitud guardados para diagnóstico.
]

Ejemplo

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "internalServerError",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Internal server error",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}