---
title: "Abono"
method: POST
path: "/payment/payout"
tags: ["Abonos", "Payouts"]
---

# Abono

`POST /payment/payout`

Transfiere fondos al `source_uuid` indicado del usuario. Para enviar dinero a una tarjeta, es necesario que ésta haya realizado alguna operación de cobro previa en el terminal. Si no se indica `source_uuid`, se seleccionará la última tarjeta que haya realizado un pago exitoso y esté asociada al `customer_ext_id` indicado al generar la orden.

También existen otras formas de transferir fondos a un usuario. Algunos servicios soportan métodos de pago alternativos como Bizum, PIX o transferencias bancarias. Si se utiliza un servicio con más de una forma de transferir fondos, es obligatorio indicar el campo `apm` para especificar cuál de ellos se utilizará. Podrá encontrar más información al respecto de estos métodos de pago en la Documentación. No todos los APM soportan abonos.

## Parameters

- `#/paths/~1/get/parameters/0` — unresolved $ref

## Request body

- object
  - `signature` Signature, required — unresolved $ref
  - `order_uuid` Uuid, required — unresolved $ref
  - `source_uuid` Uuid — unresolved $ref
  - `customer_ip` CustomerIp — unresolved $ref
  - `apm` Schema — unresolved $ref

## Response `200`

OK

- object
  - `message` string, required — Nombre del código HTTP de respuesta.
  - `code` number, required — Código de respuesta.
  - `current_time` string, required — Fecha y hora de la petición.
  - `order` Order, required
    - `uuid` string, required — Identificador único de la orden.
    - `created` string, required — Fecha de creación de la entidad.
    - `created_from_client_timezone` string, required — Fecha de creación de la entidad, usando la zona horaria del comercio.
    - `amount` Amount, required — unresolved $ref
    - `currency` string, required — Código numérico ISO 4217 de la moneda.
    - `paid` boolean, required — Identifica si el importe de la operación ya se ha liquidado (`true`) o está pendiente de liquidar (`false`).
    - `status` 'CREATED' | 'EXPIRED' | 'BLACKLISTED' | 'FRAUD' | 'PENDING_CARD' | 'PENDING_PROCESSOR_RESPONSE' | 'PENDING_3DS_RESPONSE' | 'REFUSED' | 'SUCCESS' | 'PENDING_CONFIRMATION' | 'CANCELLED' | 'REFUNDED' | 'PARTIALLY_REFUNDED' | 'PARTIALLY_CONFIRMED' | 'USER_CANCELLED' | 'REDIRECTED_TO_3DS' | 'AUTHENTICATION_REQUIRED' | 'PENDING_PAYMENT' | 'THREEDS_EXPIRED', required — Estado actual de la orden.
    - `safe` boolean, required — `true` si el pago requerirá 3D Secure. `false` en caso contrario.
    - `refunded` number, required — Importe ya devuelto, en la moneda fraccionaria elegida. Una cantidad de 100 utilizando la moneda Euro es igual a 1€.
    - `additional` Additional — unresolved $ref
    - `service` string, required — Nombre del servicio de pago asignado a la orden (REDSYSPSD2, CREDORAX...)
    - `service_uuid` string, required — El UUID del servicio de pago empleado para llevar a cabo la operación.
    - `customer` ExternalId — unresolved $ref
    - `cof_txnid` string, nullable — Identificador obtenido tras realizar un pago 3D Secure.
    - `transactions` Transaction[], required
      - `uuid` string, required — El identificador único de la transacción.
      - `created` Created, required — unresolved $ref
      - `created_from_client_timezone` CreatedFromClientTimezone, required — unresolved $ref
      - `operative` 'AUTHORIZATION' | 'DEFERRED' | 'REFUND' | 'CONFIRMATION' | 'CANCELLATION' | 'PAYOUT' | 'TRANSFER', required — Operativa de la transacción.
      - `amount` Amount, required — unresolved $ref
      - `authorization` Authorization — unresolved $ref
      - `processor_id` ProcessorId — unresolved $ref
      - `status` 'CREATED' | 'SUCCESS' | 'REFUSED' | 'ERROR' | 'PENDING' | 'CANCELLED', required — Estado de la transacción.
      - `error` string, required — Error de la transacción. Si no hay error, su valor es `"NONE"`.
      - `source` union
        - object
          - `object` Object, required — unresolved $ref
          - `uuid` string, required — Identificador de la tarjeta.
          - `type` 'CREDIT' | 'DEBIT' | '', required — Tipo de tarjeta (Crédito/Débito o desconocido).
          - `token` string, required — Token que identifica de forma única el PAN de una tarjeta. Dos tarjetas con el mismo PAN tienen el mismo token.
          - `brand` 'VISA' | 'DISCOVER' | 'AMERICAN_EXPRESS' | 'MASTERCARD' | 'DINERS_CLUB_INTERNATIONAL' | 'JCB' | 'UNIONPAY' | 'INTERPAY' | 'MAESTRO' | 'OTHER', required
          - `additional` Additional — unresolved $ref
          - `bank` string, required — Banco emisor de la tarjeta. Vacío si es desconocido.
          - `bin` number, required — Los 6 primeros dígitos del número de la tarjeta que componen el BIN.
          - `country` string, required — Código alfanumérico de dos letras ISO 3166 del país.
          - `expire_month` string, required — Mes de expiración de la tarjeta.
          - `expire_year` string, required — Año de expiración de la tarjeta.
          - `holder` string, required — Titular de la tarjeta.
          - `is_saved` boolean, required — Indica si el usuario ha dado consentimiento para que su tarjeta sea usada en pagos futuros. La tarjeta puede usarse para procesar pagos con independencia de este valor, es el comercio quien debe tener en cuenta este campo.
          - `last4` string, required — Últimos 4 dígitos de la tarjeta.
          - `prepaid` string — Indica si la tarjeta es prepago. Vacío si se desconoce esta información.
          - `validation_date` ValidationDate — unresolved $ref
          - `creation_date` Created, required — unresolved $ref
          - `brand_description` BrandDescription — unresolved $ref
          - `origin` 'UNKNOWN' | 'PAYMENT_CARD' | 'API' | 'SDK' | 'ONE_STEP' | 'MOTO' | 'KEYENTRY' | 'MIGRATION' | 'PROXY_PCI' | 'GOOGLE_PAY' | 'MC_C2P' | 'VISA_C2P' | 'APPLE_PAY', required — Identifica cómo se obtuvo la tarjeta.
        - object
          - `object` Object, required — unresolved $ref
          - `uuid` Uuid, required — unresolved $ref
          - `created_at` Created, required — unresolved $ref
          - `holder` Holder, required — unresolved $ref
          - `dpan` string, required — El DPAN de una tarjeta reemplaza el PAN. Los seis primeros dígitos y los cuatro últimos no se corresponden con los del PAN.
          - `last4` string, required — Últimos 4 dígitos del PAN. Estos sí se corresponden con los 4 últimos dígitos del PAN.
          - `brand` Brand, required — unresolved $ref
          - `bank` Bank, required — unresolved $ref
          - `country` Country, required — unresolved $ref
          - `type` 'CREDIT' | 'DEBIT' | '', required — Tipo de tarjeta (Crédito/Débito o desconocido).
          - `brand_description` BrandDescription — unresolved $ref
          - `prepaid` Prepaid — unresolved $ref
          - `origin` Origin — unresolved $ref
          - `additional` Additional — unresolved $ref
        - object
          - `object` Object, required — unresolved $ref
          - `uuid` Uuid, required — unresolved $ref
          - `account_holder` string, required — Titular de la cuenta bancaria.
          - `iban` string, required — IBAN de la cuenta bancaria.
          - `created_at` Created, required — unresolved $ref
          - `additional` Additional — unresolved $ref
        - object
          - `object` 'CARD' | 'TRANSFER' | 'HALCASH' | 'BIZUM' | 'BANK' | 'DYNAMIC_CARD' | 'CRYPTO' | 'PIX' | 'VIACASH' | 'COFIDIS' | 'IDEAL' | 'SOFORT' | 'KLARNA' | 'GIROPAY' | 'INESPAY' | 'PAYPAL' | 'FLOA' | 'PSE' | 'PAYLATER' | 'SPEI' | 'TRUELAYER' | 'MULTIBANCO' | 'MBWAY' | 'PAYSAFECARD' | 'PAYRETAILERS' | 'PAGO_FACIL' | 'EFECTY' | 'BOLETO' | 'LOTERICA' | 'PAYSHOP', required — El tipo del medio de pago.
        - object
          - `object` Object, required — unresolved $ref
          - `uuid` Uuid, required — unresolved $ref
          - `payer_id` string, required — Identificador único del pagador (PayerID) proporcionado por el proveedor externo, como PayPal.
          - `first_name` string, required — Nombre del usuario.
          - `last_name` string, required — Apellidos del usuario.
          - `email` string, required — Correo electrónico del usuario.
          - `country_alpha2` Country, required — unresolved $ref
          - `additional` Additional, required — unresolved $ref
          - `creation_date` Created — unresolved $ref
          - `validation_date` string — Fecha de validación de la tarjeta. Si no se validó al guardarla o no ha sido usada en al menos una `AUTHORIZATION`, este valor será `null`.
        - object
          - `object` Object, required — unresolved $ref
          - `uuid` string, required — Identificador único del medio de pago empleado para realizar el pago.
          - `masked_pan` string, required — Número de la tarjeta censurado, mostrando solo el BIN y los 4 últimos dígitos.
          - `additional` Additional — unresolved $ref
          - `validation_date` ValidationDate — unresolved $ref
          - `creation_date` Created, required — unresolved $ref
        - object
          - `object` Object, required — unresolved $ref
          - `uuid` Uuid, required — unresolved $ref
          - `bin` Bin, required — unresolved $ref
          - `last_4` Last4, required — unresolved $ref
          - `additional` Additional — unresolved $ref
          - `validation_date` ValidationDate — unresolved $ref
          - `creation_date` Created, required — unresolved $ref
      - `antifraud` Antifraud — Información antifraude asociada a la transacción. Disponible solo en transacciones de pago.
        - `evaluation` 'TRUSTED' | 'RISKY' | 'FRAUD' | 'WHITELISTED' | 'BLACKLISTED' | 'GREYLISTED', required — Resultado de la evaluación antifraude.
        - `fraud_score` number, required — Umbral de fraude configurado en el antifraude del servicio. Si `score` es igual o lo supera, el pago será marcado como fraudulento y no se intentará cobrar.
        - `risk_score` number, required — Umbral de riesgo configurado en el antifraude del servicio. Si `score` es igual o lo supera, el pago deberá finalizarse mediante 3D Secure obligatoriamente.
        - `score` number, required — Puntuación total de las reglas antifraude evaluadas.
        - `triggered_rules` unknown[], required — Listado de reglas antifraude activadas para esta transacción.
          - unknown
      - `device` object, nullable
        - `fingerprint` string, required — Huella digital del dispositivo empleado para realizar el pago.
        - `user_agent` string, required — La cabecera User-Agent del navegador empleado para realizar el pago.
      - `error_details` object, nullable — Objeto con información sobre el motivo de rechazo de la operación.
        - `error_code` string, nullable — Código de error devuelto por el emisor.
        - `error_description` string, nullable — Texto descriptivo asociado al error_code.
        - `error_code_scheme` string, nullable — Código de error devuelto por las marcas.
        - `error_description_scheme` string, nullable — Texto descriptivo asociado al error_code_scheme.
        - `error_unified` string, nullable — Cadena de texto asociada al campo error_code_scheme. En caso de tener multiadquirencia, este campo contendrá el mismo valor para un mismo motivo de rechazo entre los diferentes adquirentes.
      - `bizum` object, nullable — Objeto con información del pago Bizum.
        - `account` string, nullable — Cuenta bancaria del usuario enmascarada.
        - `phone_number` string, nullable — Número de teléfono enmascarado que el usuario ha utilizado para realizar la transacción.
      - `metadata` object, nullable — Contiene los pares clave-valor de datos asociados por el comercio.
    - `token` string, nullable — Token utilizado para mostrar la carta de pago. Caduca al cabo de 10 minutos por defecto.
    - `ip` CustomerIp — unresolved $ref
    - `reference` string, nullable — Referencia de la orden. Puede ser utilizado como identificador externo o para evitar pagos duplicados.
    - `dynamic_descriptor` string, nullable — Descriptor dinámico del cargo en la cuenta bancaria del cliente. Puede no concordar exactamente con este valor.
    - `threeds_data` object, nullable — Parámetros empleados durante el proceso de autenticación de 3D Secure.
      - `version` '1.0' | '2.1' | '2.2', required
      - `flow` 'FRICTIONLESS' | 'FINGERPRINTING_ONLY' | 'CHALLENGE_ONLY' | 'FULL' | 'V1_FALLBACK' | 'V1' | 'EXTERNAL', required
      - `sca_requested` boolean, required — Indica si la autenticación reforzada (SCA) tuvo lugar durante el proceso de pago.
      - `status` TransStatus — unresolved $ref
      - `eci` Eci — unresolved $ref
      - `exemption` 'LV' | 'TRA' | 'MIT' | 'SCP' | 'TB', nullable
    - `urls` object — La orden generada puede contener las urls de pago para la carta de pago, bizum y pago tokenizado. Este campo solo aparecerá si está habilitado en las preferencias del cliente.
      - `payment_card` string — Url para redirigir a la carta de pago.
      - `bizum` string — Url para redirigir al pago por Bizum, solamente si el servicio de pago soporta este método.
      - `3ds_tokenized` string — Url para redirigir al pago tokenizado, solamente si se indican los parámetros para el pago tokenizado por 3DS.
    - `dcc` object — Objeto que sólo se mostrará en pagos que hayan usado DCC, con información acerca del mismo.
      - `fee` string, required — Comisión aplicada sobre el valor del BCE.
      - `change` number, nullable — Cambio aplicado entre la moneda del comercio y la de la tarjeta.
      - `mode` DccMode, required — unresolved $ref
      - `selection` 'CARD' | 'COMMERCE' | 'NONE', required — tipo de DCC aplicado. Esto dependerá de la configuración que tenga el comercio.
      - `card_currency` string, required — Moneda de la tarjeta en formato ISO 4217.
      - `merchant_currency` string, required — Moneda del comercio en formato ISO 4217.
      - `ecb_change` number, nullable — Tipo de cambio indicado por el BCE.
  - `client` Client, required
    - `uuid` string, required — Identificador del cliente.

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/paylands/apis/documentacio-n-de-paylands.md) · [All operations](https://skmtc.net/paylands/apis/documentacio-n-de-paylands/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylands/documentacio-n-de-paylands/revisions/6bf9c0ba354b/schema)