Crear retiro extendido a tarjeta bancaria
POST/api/withdrawal/bank-card-extended
Crea un retiro a una tarjeta bancaria externa con datos ampliados del destinatario y devuelve la transacción creada.
Solicitud
- application/json
- Body
- Ejemplo
Cuerpo de la solicitudobligatorio
Datos para crear un retiro extendido a tarjeta bancaria.
ID de la billetera de origen.
W000000000001Monto.
Valores posibles: >= 0
10.25Acción.
Valores posibles: [GIVE, GET]
GIVENota.
Valores posibles: <= 255 caracteres
Sandbox transfer noteMoneda de origen.
Valores posibles: [USD, EUR, GBP, RUB, UAH, KZT, BRL, TRY, AZN, ARS, AUD, BDT, CAD, CLP, COP, DOP, EGP, HKD, INR, IDR, JPY, MYR, MXN, MAD, NPR, NZD, PKR, PEN, PHP, SGD, ZAR, KRW, LKR, THB, AED, VND, CNY, CNH, BTC, BNB, BNB_BEP20, BNB_BEP2, BNB_ERC20, BCH, DAI, DOGE, DOGE_DOGENT, DOGE_BEP2, DOGE_BEP20, ETH, LTC, USDP, XRP, SHIB, SHIB_BEP20, SHIB_ERC20, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, TUSD, USDC, USDC_ERC20, USDC_BEP20, USDC_BEP2, ZEC, BUSD, BUSD_BEP20, BUSD_ERC20, BUSD_TRC20, TON, SOL, ADA, AVAX, DOT, LINK, NEAR, POL, DASH, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]
USDMoneda de destino.
Valores posibles: [USD, EUR, GBP, RUB, UAH, KZT, BRL, TRY, AZN, ARS, AUD, BDT, CAD, CLP, COP, DOP, EGP, HKD, INR, IDR, JPY, MYR, MXN, MAD, NPR, NZD, PKR, PEN, PHP, SGD, ZAR, KRW, LKR, THB, AED, VND, CNY, CNH, BTC, BNB, BNB_BEP20, BNB_BEP2, BNB_ERC20, BCH, DAI, DOGE, DOGE_DOGENT, DOGE_BEP2, DOGE_BEP20, ETH, LTC, USDP, XRP, SHIB, SHIB_BEP20, SHIB_ERC20, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, TUSD, USDC, USDC_ERC20, USDC_BEP20, USDC_BEP2, ZEC, BUSD, BUSD_BEP20, BUSD_ERC20, BUSD_TRC20, TON, SOL, ADA, AVAX, DOT, LINK, NEAR, POL, DASH, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]
USDNúmero de tarjeta.
411111******1111receiverInfo object
Esquema Merchant Receiver Info.
Nombre.
Valores posibles: <= 30 caracteres
LeoApellido.
Valores posibles: <= 30 caracteres
PeoFecha de nacimiento.
30/01/1991Nombre de la empresa.
Valores posibles: >= 3 caracteres and <= 100 caracteres
PotterCompany{
"srcWalletId": "W000000000001",
"amount": 10.25,
"action": "GIVE",
"note": "Sandbox transfer note",
"srcCurrency": "USD",
"destCurrency": "USD",
"cardNumber": "411111******1111",
"receiverInfo": {
"status": "success"
}
}
Respuestas
- 200
- 400
- 401
- 404
- 500
OK
- application/json
- Esquema
- Ejemplo
Esquema
ID de la transacción.
11111111-1111-4111-8111-111111111111Tipo de método de pago.
Valores posibles: [INTERNAL_OWN, INTERNAL_OTHERS, INTERNAL_SCI, CRYPTOWALLET, CRYPTO_EXTERNAL, BALANCE_ADJUSTMENT, CURRENCY_EXCHANGE_ADJUSTMENT, SYSTEM_PAYMENT, BANK_CARD_TEST_PAYMENT, SYSTEM_BONUS, USER_SUBSCRIPTION, BANK_CARD, BANK_CARD_LIMITED, BANK_CARD_EXTENDED, APPLE_PAY_CRYPTO, GOOGLE_PAY_CRYPTO, VISA, VISA_EXTENDED, VISA_LIMITED, MASTERCARD, MASTERCARD_EXTENDED, MASTERCARD_LIMITED, AMERICAN_EXPRESS, DINERS_CLUB, DISCOVER, INSTAPAYMENT, JCB, LASER, MAESTRO, MIR, YANDEX_MONEY, SWIFT, SEPA, SWIFT_EUR, LOCAL_BANK_TRANSFER, EPS_LOCAL_BANK_TRANSFER, EPS_SWIFT, EPS_CIPS, EPS_FPS, EPS_BANK_CARD_RU, CRYPTO_COLLECTION, CARD_PROGRAM_ISSUE_PAYMENT, CARD_PROGRAM_DELIVERY_PAYMENT, CARD_PROGRAM_VIEW_PIN_PAYMENT, CARD_PROGRAM_MONTHLY_FEE, CARD_PROGRAM_YEARLY_FEE, CARD_PROGRAM_REACTIVATION_FEE, CARD_PROGRAM, GLOBAL_PLUS, EUROPE_VISA_PLASTIC, EUROPE_VISA_VIRTUAL, EUROPE_MC_PLASTIC, EUROPE_MC_VIRTUAL, APAC_MC_PLASTIC, DIGITAL]
INTERNAL_OWNTipo de transacción.
Valores posibles: [DEPOSIT, INTERNAL_TRANSFER_OTHER, INTERNAL_TRANSFER_OWN, SMS_DELIVERY_PAYMENT, ADDITIONAL_COMMISSION, SYSTEM_PAYMENT, WITHDRAWAL, REFUND]
DEPOSITEstado.
Valores posibles: [PENDING, COMPLETED, CANCELED, REFUNDED]
COMPLETEDDirección del movimiento.
Valores posibles: [DEPOSIT, WITHDRAWAL]
DEPOSITDirección de la transacción.
Valores posibles: [INCOMING, OUTGOING, EXCHANGE]
OUTGOINGMoneda.
Valores posibles: [USD, EUR, GBP, RUB, UAH, KZT, BRL, TRY, AZN, ARS, AUD, BDT, CAD, CLP, COP, DOP, EGP, HKD, INR, IDR, JPY, MYR, MXN, MAD, NPR, NZD, PKR, PEN, PHP, SGD, ZAR, KRW, LKR, THB, AED, VND, CNY, CNH, BTC, BNB, BNB_BEP20, BNB_BEP2, BNB_ERC20, BCH, DAI, DOGE, DOGE_DOGENT, DOGE_BEP2, DOGE_BEP20, ETH, LTC, USDP, XRP, SHIB, SHIB_BEP20, SHIB_ERC20, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, TUSD, USDC, USDC_ERC20, USDC_BEP20, USDC_BEP2, ZEC, BUSD, BUSD_BEP20, BUSD_ERC20, BUSD_TRC20, TON, SOL, ADA, AVAX, DOT, LINK, NEAR, POL, DASH, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]
USDMonto.
10.25Fecha de creación.
Ámbito del pago.
Valores posibles: [PERSONAL, BUSINESS, MERCHANT_API, PAYMENT_GATEWAY]
PERSONALID del pedido.
ORDER_123456ID de la billetera de origen.
W000000000001ID de la billetera de destino.
W000000000001Comisión total.
10.25Comentario.
Sandbox transfer noteHash de la transacción cripto.
4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5eFecha de finalización.
{
"transactionId": "11111111-1111-4111-8111-111111111111",
"paymentMethodType": "BANK_CARD_EXTENDED",
"transactionType": "WITHDRAWAL",
"status": "CREATED",
"direction": "WITHDRAWAL",
"transactionDirection": "OUTGOING",
"currency": "USD",
"amount": 10.25,
"createdAt": "2026-01-15T10:30:00",
"paymentScope": "PERSONAL",
"orderId": "ORDER_123456",
"walletSrcId": "W000000000001",
"walletDestId": "W000000000001",
"fullCommission": 10.25,
"comment": "Sandbox transfer note",
"cryptoCurrencyTxHash": "4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e",
"completedAt": "2026-01-15T10:30:00"
}
Solicitud incorrecta. La solicitud tiene un formato incorrecto o contiene parámetros no válidos.
- application/json
- Esquema
- Ejemplo
Esquema
- Array [
- ]
Estado de la respuesta.
Valores posibles: [error]
errordata objectobligatorio
Datos de la respuesta de error.
errors object[]obligatorio
Lista de errores devueltos para la solicitud.
Código de error estable y legible por máquina.
disabledCategoría del error.
FORMIdentificador único y corto del error para soporte y registros.
errTest1234Descripción legible del error.
REQUESTED OPERATION IS DISABLED FOR THE MERCHANT APICampo de la solicitud relacionado con el error, si lo hay.
nullParámetros adicionales del error.
Parámetros de la solicitud guardados para diagnóstico.
{
"status": "error",
"data": {
"errors": [
{
"errorMessage": "disabled",
"errorType": "FORM",
"errorId": "errTest1234",
"errorDescription": "REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API",
"errorField": null,
"params": [],
"requestParams": {}
}
]
}
}
No autorizado. Faltan los encabezados de autenticación del comercio o no son válidos.
- application/json
- Esquema
- Ejemplo
Esquema
- Array [
- ]
Estado de la respuesta.
Valores posibles: [error]
errordata objectobligatorio
Datos de la respuesta de error.
errors object[]obligatorio
Lista de errores devueltos para la solicitud.
Código de error estable y legible por máquina.
userDoesNotExistExceptionCategoría del error.
GENERALIdentificador único y corto del error para soporte y registros.
errTest1234Descripción legible del error.
NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]Campo de la solicitud relacionado con el error, si lo hay.
nullParámetros adicionales del error.
Parámetros de la solicitud guardados para diagnóstico.
{
"status": "error",
"data": {
"errors": [
{
"errorMessage": "userDoesNotExistException",
"errorType": "GENERAL",
"errorId": "errTest1234",
"errorField": null,
"params": [],
"requestParams": {}
}
]
}
}
No encontrado. El recurso solicitado no existe.
- application/json
- Esquema
- Ejemplo
Esquema
- Array [
- ]
Estado de la respuesta.
Valores posibles: [error]
errordata objectobligatorio
Datos de la respuesta de error.
errors object[]obligatorio
Lista de errores devueltos para la solicitud.
Código de error estable y legible por máquina.
resourceNotFoundCategoría del error.
GENERALIdentificador único y corto del error para soporte y registros.
errTest1234Descripción legible del error.
Resource not foundCampo de la solicitud relacionado con el error, si lo hay.
nullParámetros adicionales del error.
Parámetros de la solicitud guardados para diagnóstico.
{
"status": "error",
"data": {
"errors": [
{
"errorMessage": "resourceNotFound",
"errorType": "GENERAL",
"errorId": "errTest1234",
"errorDescription": "Resource not found",
"errorField": null,
"params": [],
"requestParams": {}
}
]
}
}
Error interno del servidor. Error inesperado, contacta al soporte
- application/json
- Esquema
- Ejemplo
Esquema
- Array [
- ]
Estado de la respuesta.
Valores posibles: [error]
errordata objectobligatorio
Datos de la respuesta de error.
errors object[]obligatorio
Lista de errores devueltos para la solicitud.
Código de error estable y legible por máquina.
internalServerErrorCategoría del error.
GENERALIdentificador único y corto del error para soporte y registros.
errTest1234Descripción legible del error.
Internal server errorCampo de la solicitud relacionado con el error, si lo hay.
nullParámetros adicionales del error.
Parámetros de la solicitud guardados para diagnóstico.
{
"status": "error",
"data": {
"errors": [
{
"errorMessage": "internalServerError",
"errorType": "GENERAL",
"errorId": "errTest1234",
"errorDescription": "Internal server error",
"errorField": null,
"params": [],
"requestParams": {}
}
]
}
}