POST

/payments/payment-wc

Crea una orden de pago hacia un cliente a través de su número de celular. Requiere el token obtenido en el paso anterior.

Endpoint

https://api-comecom-uat.yappycloud.comhttps://apipagosbg.bgeneral.cloud/payments/payment-wc

Headers

HeaderValor
AuthorizationToken generado en validate/merchant. No incluye Bearer.

Request

CampoTipo / formatoReqDescripción
merchantIdUUIDsíIdentificador del comercio.
orderIdalfanumérico, 1–32 chars  ↑ v2.1 síIdentificador de la orden de tu lado. Debe ser único.
domainstringsíDominio registrado (debe coincidir con urlDomain de validate).
paymentDateepoch (number)síValor epochTime recibido en validate/merchant.
aliasYappystring · 8 dígitossíCelular panameño del cliente, sin guiones ni prefijo.
ipnUrlURLsíURL pública GET de tu backend que recibirá el IPN.
shipping”0.00”síCosto de envío. Mínimo “0.00”.
discount”0.00”síDescuento aplicado. Mínimo “0.00”.
taxes”0.00”síImpuestos. Mínimo “0.00”.
subtotal”0.01”síSubtotal. Mínimo “0.01”.
total”0.01”síMonto total a cobrar. Entre $0.01 y $9,999.99.
NO incluyas successUrl ni failUrl

Botón de Pago no usa redirect URLs. Si los envías el request puede fallar o ser ignorado. El estado final de la transacción siempre llega al endpoint de IPN configurado en ipnUrl.

Body de ejemplo

{
  "merchantId": "5c2d13e5-537f-43f1-b1d0-d90d8fdaf8be",
  "orderId": "ORD12345",
  "domain": "https://www.tudominio.com",
  "paymentDate": 1777301827,
  "aliasYappy": "60021001",
  "ipnUrl": "https://www.tudominio.com/api/yappy/ipn",
  "shipping": "0.00",
  "discount": "0.00",
  "taxes": "0.35",
  "subtotal": "5.00",
  "total": "5.35"
}

Response 200 OK

{
  "status": {
    "code": "0000",
    "description": "Correct execution"
  },
  "body": {
    "transactionId": "MRALB-83409803",
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "documentName": "transactions"
  }
}
Error común: E004 "Los valores de los atributos no son válidos"

Este error genérico usualmente significa:

  • El aliasYappy no tiene exactamente 8 dígitos
  • El orderId excede 32 caracteres o contiene caracteres especiales
  • El monto no tiene formato "0.00" (dos decimales como string)
  • Hay smart quotes (" ") en lugar de comillas rectas (" ")

Revisa estos 4 puntos antes de contactar soporte.

¿Te fue útil esta página?