Fast Checkout Shipping

​

How it works

1. You create the checkout session with the delivery options you offer (shipping_methods).
2. Yuno forwards those options to the wallet when the payment is created, and the widget renders them.
3. The customer picks a saved address and a delivery method inside the widget.
4. The wallet notifies Yuno, which attaches the selection to the payment and fills customer_payer.shipping_address when the payer had none.
5. You receive the selection on the payment webhook and on GET /payments/{id}.

​

Offer delivery options on the session

{
  "amount": { "currency": "GBP", "value": 105.00 },
  "shipping_methods": [
    {
      "id": "express",
      "label": "Express shipping",
      "detail": "Arrives in 1-2 business days",
      "amount": { "currency": "GBP", "value": 5.00 },
      "summary_items": [
        { "id": "order", "label": "Order", "amount": { "currency": "GBP", "value": 100.00 } },
        { "id": "shipping", "label": "Express shipping", "amount": { "currency": "GBP", "value": 5.00 } }
      ]
    }
  ]
}

• shipping_methods[].id is merchant-defined; the selection comes back referencing it.
• Every amount uses the session currency, in major units.

​

Receive the selection on the payment

{
  "id": "3455abae-3f3b-4e30-a6d5-8f28b1e176a3",
  "status": "SUCCEEDED",
  "amount": { "currency": "GBP", "value": 105.00 },
  "customer_payer": {
    "shipping_address": {
      "address_line_1": "221B Baker Street",
      "address_line_2": "Flat 2",
      "city": "London",
      "state": "England",
      "zip_code": "NW1 6XE",
      "country": "GB"
    }
  },
  "shipping": {
    "method": {
      "id": "express",
      "label": "Express shipping",
      "amount": { "currency": "GBP", "value": 5.00 }
    },
    "address": {
      "address_line_1": "221B Baker Street",
      "address_line_2": "Flat 2",
      "city": "London",
      "state": "England",
      "zip_code": "NW1 6XE",
      "country": "GB"
    }
  }
}

​

Behavior details

• The shipping key is omitted when the payment has no shipping selection — payments without Fast Checkout are unaffected.
• shipping.method.id always matches one of the shipping_methods[].id you sent on the session; a selection that doesn’t match is discarded and the payment status still updates.
• customer_payer.shipping_address is filled from shipping.address only when the payer had no shipping address yet — an address you sent on the payment request is never overwritten.
• The selection is idempotent: repeated notifications with the same shipping don’t change the payment.

​

Availability