Saltar al contenido
Consultas

paymentMethods

Métodos de pago que ofrece el checkout de la tienda.

paymentMethods devuelve los métodos de pago del checkout: los que la tienda activó y que se pueden cobrar en su país y moneda. Úsala para mostrar con qué se puede pagar antes de llegar al checkout.

paymentMethods: [StorefrontPaymentMethodDto!]!

No recibe argumentos. Una tienda sin métodos disponibles devuelve [].

StorefrontPaymentMethodDto

CampoTipoDescripción
codeString!Código del método, por ejemplo card o cash_on_delivery.
nameString!Nombre para el comprador.
kindString!offline, card, wallet u other.
sortOrderInt!Posición configurada por la tienda.
brands[String!]!Marcas que se muestran, por ejemplo visa. Puede ser [].

La lista llega en el orden del checkout: primero el método predeterminado y luego el resto por sortOrder y por nombre. Muéstrala en ese orden.

Ejemplo

Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query PaymentMethods { paymentMethods { code name kind sortOrder brands } }"
  }'
Respuesta
{
  "data": {
    "paymentMethods": [
      {
        "code": "card",
        "name": "Tarjeta de crédito o débito",
        "kind": "card",
        "sortOrder": 30,
        "brands": ["visa", "mastercard", "amex"]
      },
      {
        "code": "cash_on_delivery",
        "name": "Pago contra entrega",
        "kind": "offline",
        "sortOrder": 10,
        "brands": []
      },
      {
        "code": "apple_pay",
        "name": "Apple Pay",
        "kind": "wallet",
        "sortOrder": 32,
        "brands": []
      }
    ]
  }
}

card va primero porque es el método predeterminado, aunque su sortOrder sea mayor.

Errores

CódigoCausa
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

GET /v1/payments/methods devuelve la misma lista.

Última actualización:

En esta página