Pago Agregado (Cobro del Comerciante por Número de Tarjeta)

Ejemplo: "1000000" es 1 USDT cuando decimales=6. Reemplace todos los marcadores de posición con detalles verificados del destinatario y del instrumento. Enviar esta solicitud puede mover fondos reales. Revisar y autorizar explícitamente la operación antes de enviarla. Consulte Inicio rápido.

Este tipo de transacción permite que un agregador de servicios de pago acepte pagos de clientes en nombre de un comerciante integrado. Los fondos se debitan del Pagador y se distribuyen entre el Comerciante (neto de la tarifa del Agregador) y el Agregador (parte de la tarifa) automáticamente.

Flujo de Negocios

1. El comerciante firma un acuerdo/se incorpora con el Agregador.
2. El agregador le indica al comerciante que cree (o proporcione) una billetera en el sistema heth.me y devuelve el wallet_id.
3. Usando su propia clave API, el Agregador crea una transacción de pago especificando los detalles de la billetera del Comerciante en money_storage_merchant y los detalles de la tarjeta del Pagador en money_storage.
4. Tras el procesamiento exitoso, los saldos del Pagador, Comerciante y Agregador se actualizan en un solo paso.
5. El estado de la transacción se puede sondear utilizando el método de recuperación de transacciones estándar (autorizado con la misma clave API).

Solicitud de ejemplo

curl --location --request POST 'https://app.heth.me/api/v1/transactions' \
  --header 'Content-Type: application/json' \
  --header "x-api-key: $HETH_API_KEY" \
  --data '{
    "params": {
      "amount": "1000000",
      "currency": "USDT",
      "env": "prod",
      "type": "payment",
      "route": "hot_hot_ETH",
      "money_storage_merchant": {
        "wallet_id": "YOUR_WALLET_ID",
        "network": "ETH",
        "type": "p2p_proxy",
        "currency": "USDT"
      },
      "money_storage": {
        "network": "ETH",
        "type": "bank_card",
        "currency": "USDT",
        "cardnumber": "YOUR_CARD_NUMBER",
        "cvv": "YOUR_CVV",
        "exp_month": "08",
        "exp_year": "2026",
        "cardholder": "John Doe"
      },
      "description": "Payment",
      "txid": "d9428888-122b-41e1-b85c-61cb3f548aa7"
    }
  }'

Referencia de campo

Campo	Descripción	Tipo	Ejemplo
amount	Monto de la transacción (cadena de un número entero en unidades menores)	String	1000000
currency	Moneda de transacción (predeterminada USDT)	String	USDT
env	prod (predeterminado). Conserve este valor al abrir y confirmar la solicitud.	String	prod
type	Tipo de transacción (pago)	String	payment
route	Ruta de procesamiento (debe coincidir con la asignación configurada)	String	hot_hot_ETH
money_storage_merchant	Descriptor de billetera del comerciante (beneficiario)	Object
> wallet_id	Identificador de billetera comercial	String	YOUR_WALLET_ID
> network	Red blockchain (TRX o ETH)	String	ETH
> type	Tipo de interacción de billetera (por ejemplo, p2p_proxy)	String	p2p_proxy
> currency	Moneda de liquidación del comerciante (predeterminado USDT)	String	USDT
money_storage	Descriptor del instrumento de financiación del pagador	Object
> network	Red blockchain (TRX o ETH)	String	ETH
> type	Tipo de instrumento (tarjeta_bancaria)	String	bank_card
> currency	Moneda del pagador (predeterminado USDT)	String	USDT
> cardnumber	Número de tarjeta virtual	String	YOUR_CARD_NUMBER
> cvv	Tarjeta virtual CVV	String	YOUR_CVV
> exp_month	Mes de caducidad de la tarjeta	String	08
> exp_year	Año de caducidad de la tarjeta	String	2026
> cardholder	Nombre del titular de la tarjeta	String	John Doe
description	Descripción legible por humanos	String	Payment
txid	Identificador de transacción idempotente (cadena)	String	d9428888-122b-41e1-b85c-61cb3f548aa7

Notas

• La lógica de tarifas del Agregador se aplica automáticamente según la configuración de la clave API.
• Asegúrese de que route coincida con una ruta de procesamiento habilitada para la clave API proporcionada.
• Utilice valores txid idempotentes para evitar envíos duplicados accidentales.
• Recuperar el estado de la transacción a través del punto final de transacción estándar GET (sondeo hasta que se alcanza un estado de terminal).