Cancel and Capture Flow

This guide explains how Yuno handles card payment flows using the payment_method.detail.card.capture field and optional delayed actions. It covers immediate capture, manual operations, and delayed automatic flows.

Capture behavior

Manual flow

If capture = false, Yuno also supports delayed execution of capture or cancel using two configuration objects:

delayed_capture_settings

{
  "delay": "P30D",
  "simplified_mode": true
}

delayed_cancel_settings

{
  "delay": "P5D",
  "simplified_mode": false
}

Use these objects to instruct Yuno to handle the capture or cancel action automatically after a delay.

• Use [capture](https://docs.y.uno/reference/capture-authorization) to complete the payment.
• Use [cancel](https://docs.y.uno/reference/cancel-or-refund-a-payment) to void the authorization.

Additional information

• Only valid when capture = false. If capture = true, these objects must be omitted or set to null.
• If you call the capture or cancel endpoints manually before the delay is reached, Yuno will cancel the scheduled automatic action.

Example request

{
  "country": "US",
  "amount": {
    "currency": "USD",
    "value": "20000"
  },
  "customer_payer": {
    "merchant_customer_validations": {
      "account_is_verified": true,
      "email_is_verified": true,
      "phone_is_verified": true
    },
    "id": "<customer_id>",
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]"
  },
  "workflow": "DIRECT",
  "payment_method": {
    "detail": {
      "card": {
        "capture": false,
        "delayed_capture_settings": {
          "delay": "P20D",
          "simplified_mode": true
        },
        "delayed_cancel_settings": {
          "delay": "P40D",
          "simplified_mode": true
        },
        "card_data": {
          "number": "4111111111111111",
          "expiration_month": 11,
          "expiration_year": 28,
          "security_code": "123",
          "holder_name": "John Doe"
        },
        "verify": false
      }
    },
    "type": "CARD"
  },
  "account_id": "<account_id>",
  "description": "Payment with card details",
  "merchant_order_id": "000023"
}

When to use delayed actions

Use delayed_capture_settings or delayed_cancel_settings when:

• You want Yuno to automatically finalize or void an authorized transaction.
• You don’t want to rely on manually calling the capture or cancel endpoints.
• You need retry behavior in case of failure (simplified_mode = true).

Field reference