CardV para Dujiao-Next

Obtén tu clave de API ↗

#Qué necesitas

Ante tus clientes, el vendedor eres tú: fijas los precios, respondes a sus preguntas y te encargas de sus reembolsos.

#Paso 1: Obtén tu clave de API

Usa la clave de API que ya tienes en el Portal de comercios, en API y webhooks > Claves de API. No necesitas una clave aparte para Dujiao-Next.

• El Key ID empieza por ck_live_.
• El secreto de firma empieza por cs_live_. Solo se muestra una vez, al crear la clave. Si ya no lo tienes, usa Regenerar secreto en la clave. El Key ID no cambia, y el secreto anterior deja de funcionar al instante.

Las claves antiguas sin Key ID no se pueden usar. En ese caso, crea una clave nueva en el Portal.

#Paso 2: Añade la conexión

En el panel de Dujiao-Next, abre Integration > Connection Management > New Connection y rellena el formulario:

El tipo de cambio y el margen se combinan así: precio de CardV × tipo de cambio × (1 + margen), y luego se redondea. Por ejemplo, con un tipo de cambio de 7.2 (solo es un ejemplo; introduce el tipo actual que consultes) y un margen del 15 %, una tarjeta de 5.78 USD se vende a 47.9.

Cuando cambie el tipo de cambio, actualízalo en la conexión y haz clic en Reapply Markup para actualizar los precios de los productos que ya importaste. Haz lo mismo cuando cambies el margen.

#Paso 3: Prueba la conexión

Haz clic en Ping en la conexión. Ping succeeded significa que tu clave funciona, y el estado de la conexión pasa a Active. Si en su lugar ves un error, consulta Solución de problemas.

#Paso 4: Importa productos

1. Abre Integration > Product Mappings > Import from Upstream y elige tu conexión de CardV.
2. Explora por categoría, o cambia a Flat List para elegir productos sueltos.
3. Elige una categoría local, o marca Auto-create local categories. Un producto necesita una categoría para poder guardarlo.
4. Importa. Cada producto conserva su título, su descripción, sus instrucciones de canje y sus valores nominales (como 10 USD).

Los productos importados quedan sin publicar. Revisa cada uno y luego activa Active en el editor del producto.

#Paso 5: Limita a un artículo por pedido

En cada producto importado, abre el editor del producto y pon Max purchase quantity en 1.

CardV entrega un artículo por pedido. Si un cliente paga dos códigos en un mismo pedido, CardV rechaza la compra y tienes que resolver ese pedido a mano. Dujiao-Next no puede recibir este límite de CardV automáticamente, así que configúralo tú.

Ya que estás en el editor, también te recomendamos:

• Visualización del stock en la tienda: elige Hide quantity. CardV compra a la marca cuando llega un pedido, así que la cifra de stock que muestra tu tienda solo significa "disponible".
• Imágenes: añade las tuyas si un producto no tiene ninguna.

#Cómo funciona la entrega

1. El cliente paga en tu tienda.
2. Tu tienda envía la compra a CardV, y CardV cobra el importe de tu saldo de CardV.
3. Tu tienda consulta el pedido en CardV. En nuestras pruebas, el código llegó en menos de un minuto.
4. El código aparece en la página del pedido del cliente como Code, PIN (si la tarjeta tiene uno) y Expires (si la tarjeta tiene fecha de caducidad). Siempre es un código, nunca un enlace.

Recargas directas. Algunos productos se abonan directamente en la cuenta del cliente en el juego o la aplicación. Al pagar, el cliente rellena los datos que necesita el producto, como un ID de jugador o un número de teléfono. Cuando la recarga termina, la página del pedido del cliente muestra Top-up completed.

Si CardV no puede entregar. CardV reembolsa el pedido a tu saldo de CardV, y tu tienda marca la compra como cancelada. Después, reembolsas o ayudas al cliente en tu tienda.

#Qué no está disponible

La lista de importación solo muestra los productos que tu tienda puede vender a través de esta conexión:

• Solo valores nominales fijos. No aparecen las tarjetas en las que el cliente escribe su propio importe.
• No aparecen: recargas de saldo móvil, productos de pago y billeteras, cripto y tarjetas de pago prepago.
• Solo códigos. No aparecen los productos que solo se pueden entregar como enlace.

Los precios que ves son tus propios precios de CardV en USD.

#Lista de IP permitidas

Si configuras una lista de IP permitidas en el Portal de comercios, añade la dirección IP pública del servidor donde funciona tu tienda Dujiao-Next. Si no, CardV rechaza todas las solicitudes que vengan de él. La misma clave, la misma lista de IP y los mismos límites de solicitudes se aplican a la API de CardV y a Dujiao-Next.

#Solución de problemas

Estos mensajes aparecen en el panel de Dujiao-Next, tras Ping, durante la importación o en una compra en Procurement Orders.

#Preguntas frecuentes

¿Necesito una clave de API nueva para Dujiao-Next? No. Usa la clave de API firmada que ya tienes. Si también usas la clave para tu propia integración con la API de CardV, ambas comparten los mismos límites de solicitudes.

¿Por qué dejo vacía la Callback URL? CardV no envía callbacks a las tiendas. Tu tienda Dujiao-Next consulta cada pedido por su cuenta hasta que el resultado es definitivo.

¿Qué pasa cuando cambian los precios de CardV? Con Auto-update price on sync activado, tus precios de venta se recalculan con tu tipo de cambio y tu margen en la siguiente sincronización. Si está desactivado, tu tienda sigue vendiendo al precio anterior.

¿Dónde veo estos pedidos en CardV? En la página Pedidos del Portal de comercios. La columna Su ID de pedido empieza por dujiao: seguido del número de subpedido de Dujiao-Next (por ejemplo dujiao:DJ…-01). Si configuraste webhooks de CardV, también se envían para estos pedidos.

¿Puedo cambiar los títulos, las descripciones y las imágenes de los productos? Sí. La sincronización actualiza los precios y la disponibilidad. No sobrescribe tus títulos ni tus imágenes.

¿Puedo vender importes personalizados? Todavía no a través de Dujiao-Next. Solo están disponibles los valores nominales fijos.

#Soporte

Escribe a [email protected] indicando tu Merchant ID, el número de pedido de Dujiao-Next y el mensaje de error. El uso de CardV se rige por nuestros Términos del servicio.