Visión general #

Hay cuatro pasos para crear una caja completa:

1. Crear un producto
2. Crear un precio
3. Crear una caja
4. Ir al cajero para completar el pago

Crear un producto #

Los productos y los precios son recursos fundamentales para muchas integraciones WooshPay. Los productos definen lo que ofrece su empresa, ya sean bienes o servicios.

Solicitar

{
    "nombre": "producto de ejemplo",
    "active":true
    "descripción": "alguna descripción",
    "metadatos":{
        "key1": "valor1",
        "clave3": "valor3"
    },
    "url": "www.example.com"
}

Respuesta

{
    "id": "prod_1554351292598452224",
    "objeto": "producto",
    "creado": 1665642282000,
    "activo": true
    "descripción": "descripción",
    "metadatos": {
        "clave1": "valor1",
        "key2": "valor2"
    },
    "name": "producto de ejemplo",
    "livemode": false
    "url": "www.example.com",
    "updated": 1665642282000,
    "images": null
}

Crear un precio #

Los precios definen cuánto y con qué frecuencia cobrar por los productos. Puede crear uno o varios precios para un producto.

Solicitud 1： Vincular directamente el producto existente

{
    "moneda": "GBP",
    "product":"prod_1554351292598452224",
    "unit_amount":5
    "activo":true
    "metadatos":{
        "key1": "valor1",
        "key2": "valor2"
    },
    "apodo": "algún apodo",
    "product_data":null,
    "lookup_key": "test_lookup_key"
}

Solicitud 2：Crear un nuevo producto mientras se crea un precio.

{
    "divisa": "GBP",
    "producto":null,
    "unit_amount":5,
    "activo":true
    "metadatos":{
        "key1": "valor1",
        "clave2": "valor2"
    },
    "apodo": "fengli",
    "datos_producto":{
        "id":null
        "name": "producto_ejemplo",
        "activo":true
        "description": "muy delicioso",
        "metadatos":{
            "key1": "valor1",
            "key2": "valor2"
        },
        "url": "www.example.com"
    },
    "billing_scheme": "testscheme",
    "lookup_key": "test_lookup_key"
}

Respuesta

{
    "id":"price_1554384814788837376",
    "object": "precio",
    "created":1659429194000,
    "activo":true
    "moneda": "GBP",
    "metadatos":{
        "clave1": "valor1",
        "clave2": "valor2"
    },
    "apodo": "algún apodo",
    "producto":{
        "id":"prod_1554351292598452224",
        "object": "producto",
        "created":1659421201000,
        "activo":true,
        "descripción": "muy delicioso",
        "metadatos":{
            "key1": "valor1",
            "key3": "valor3"
        },
        "name": "taiwan fengli",
        "livemode":false
        "url": "www.example.com",
        "updated":1659422039000
    },
    "type": "one_time",
    "livemode":false
    "unit_amount":5,
    "billing_scheme": "per_unit",
    "lookup_key": "test_lookup_key"
}

Crear pago #

Una sesión de pago es la representación programática de lo que su cliente ve cuando es redirigido al formulario de pago. Puede configurarla con opciones como:

• artículos_de_línea cobrar
• divisas a utilizar

También debe especificarlo:

• A URL_éxitoUna página en su sitio web para redirigir a su cliente después de completar el pago.
• A cancelar_urluna página en su sitio web para redirigir a su cliente si hace clic en su logotipo en Checkout.

Nota: Las sesiones de pago caducan 24 horas después de su creación.

Solicitar

{
    "cancel_url": "www.example.com",
    "mode": "payment",
    "success_url": "www.wooshpay.com",
    "line_items":[
        {
            "price_data":{
                "currency": "GBP",
                "product":null
                "unit_amount":5
                "activo":true
                "metadatos":{
                    "key1": "valor1",
                    "clave2": "valor2"
                },
                "apodo": "fengli",
                "datos_producto":{
                    "id":null
                    "name": "producto_ejemplo",
                    "activo":true
                    "description": "muy delicioso",
                    "metadatos":{
                        "key1": "valor1",
                        "key2": "valor2"
                    },
                    "url": "www.example.com"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity":1
        }
    ]
}

Respuesta

{
    "id":"cs_1580071142008291328",
    "object": "checkout.session",
    "created":1665553291000,
    "moneda": "GBP",
    "customer": "cliente",
    "mode": "payment",
    "livemode":false
    "shipping":null,
    "status": "abierto",
  "url": "https://checkouttest.wooshpay.com/pay/cs_test_1580071142008291328?key=pk_test_dGVzdDpXWUg1eUF4OXZpUUF4UHNoYmdRRjVTTTE=",
    "cancel_url": "www.baidu.com",
    "client_reference_id":null,
    "customer_email":null,
    "line_items":{
        "object": "lista",
        "data":[
            {
                "id":"li_1580071142847152128",
                "object": "item",
                "currency": "GBP",
                "descripción": "producto de ejemplo",
                "precio":{
                    "id":"price_1580071142859735040",
                    "object": "precio",
                    "created":1665553291000,
                    "activo":true
                    "moneda": "GBP",
                    "metadatos":{
                        "clave1": "valor1",
                        "clave2": "valor2"
                    },
                    "apodo": "fengli",
                    "producto":{
                        "id":"prod_1580071142880706560",
                        "object": "producto",
                        "created":1665553291000,
                        "activo":true
                        "descripción": "alguna descripción",
                        "metadatos":{
                            "clave1": "valor1",
                            "clave2": "valor2"
                        },
                        "name": "producto de ejemplo",
                        "livemode":false
                        "url": "www.example.com",
                        "updated":1665553291000,
                        "images":null
                    },
                    "type": "one_time",
                    "livemode":false
                    "unit_amount":5,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "cantidad":1
                "amount_subtotal":5,
                "amount_total":5
            }
        ],
        "url":null
        "has_more":null
    },
    "payment_intent":"pi_1580071150141046784",
    "payment_method_types":null,
    "payment_status": "impagado",
    "success_url": "www.wooshpay.com",
    "amount_subtotal":5,
    "amount_total":5,
    "billing_address_collection": "auto",
    "expires_at":1665639691214,
    "payment_link":"",
    "payment_method_options":null,
    "phone_number_collection":null,
    "shipping_address_collection":null,
    "client_secret":"pi_1580071150141046784_secret_bsOGcAMewpe6orzCbZHMlomu"
}

Redirigir la URL #

Después de crear una sesión de pago, redirija a su cliente a la URL devuelta en la respuesta.