Skip to content
Preview

This feature is for preview only and is subject to change.

The delegate token is created as part of the Agentic Commerce Protocol (ACP) flow for ChatGPT instant checkout

How to enable

After receiving the delegate token from the agent (e.g. ChatGPT) apply it in the Payments API request by setting:

  • instruction.method to card
  • instruction.paymentInstrument.type to delegate.

Delegate Session

{
    "transactionReference": "order1234",
    "merchant": {
        "entity": "default"
    },
    "instruction": { 
        "method": "card", 
        "paymentInstrument": {
            "type": "delegate",
            "sessionHref": "https://try.access.worldpay.com/sessions/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"
        },
        "customer": {
            "email": "john.appleseed@example.com",
            "phone": "00000000000",
            "ipAddress": "192.168.0.1"
        },
        "narrative": {
            "line1": "trading name"
        },
        "value": {
            "currency": "GBP",
            "amount": 42
        }
    }
}

Feature limitations

The delegate token flow is currently restricted to guest card payments.

3DS, SCA Exemptions and Worldpay token creation are not available.

Sequence diagram

AgentMerchantWorldpay Sessions APIWorldpay Payments APIopt[: if valid]Product feed (step 1)POST to /checkout_sessions (step 2)Return PSP information inc. checkoutIdPOST to /sessions/agentic_commerce/delegate_payment (step 3)Store delegate payment dataReturn delegate token (sessionHref)POST to /checkout_sessions/{id}/complete {payment_data:href} (step 4)POST to /api/payments {instruction.paymentInstrument.sessionHref} (step 5)GET {sessionHref}Lookup sessionReturn delegate payment dataValidate delegate payment data against instructionAuthorize paymentReturn payment outcomeReturn payment outcomeAgentMerchantWorldpay Sessions APIWorldpay Payments API