> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dollarpe.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Wallet

> Deletes a wallet linked to a customer.

<Prompt description="Delete Wallet" actions={["cursor"]}>
  Integrate the Zapyd Delete Wallet endpoint into my application.

  Endpoint: DELETE /customer/wallet/{customer_id}/{wallet_id}/delete
  Base URL: [https://sandbox.zapyd.com/cms/api/v1](https://sandbox.zapyd.com/cms/api/v1) (sandbox) | [https://api.zapyd.com/cms/api/v1](https://api.zapyd.com/cms/api/v1) (production)
  Full URL (sandbox): DELETE [https://sandbox.zapyd.com/cms/api/v1/customer/wallet/\{customer\_id}/\{wallet\_id}/delete](https://sandbox.zapyd.com/cms/api/v1/customer/wallet/\{customer_id}/\{wallet_id}/delete)

  Auth headers required on every request:

  * X-API-KEY: your API key
  * X-TIMESTAMP: current Unix time in seconds
  * X-SIGNATURE: Base64(HMAC-SHA256(key=apiSecret, data=X-API-KEY + "|" + X-TIMESTAMP + "|" + canonicalBody))
    canonicalBody = request JSON with keys sorted at every nesting level, no whitespace (separators "," and ":"), non-ASCII escaped as lowercase \uXXXX. GET requests always sign "{}" (query params are not signed). Send the exact canonicalBody string as the request body. Timestamp must be within 300s of server time.

  Task: Write a typed function that:

  1. Accepts customer\_id (UUID) and wallet\_id (integer)
  2. Builds the signed auth headers over an empty body ("{}")
  3. Calls DELETE /customer/wallet/{customer_id}/{wallet_id}/delete
  4. Returns the deleted wallet object
  5. Handles 400 (wallet or customer not found) and 500 errors

  Language: TypeScript
</Prompt>


## OpenAPI

````yaml DELETE /customer/wallet/{customer_id}/{wallet_id}/delete
openapi: 3.1.0
info:
  title: Zapyd API
  description: API for Zapyd - Customer, Payout, and Webhook services
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://sandbox.zapyd.com/pos/api/v1
    description: Payout API Base URL
    variables:
      base_url:
        default: https://sandbox.zapyd.com
  - url: https://sandbox.zapyd.com/cms/api/v1
    description: Customer API Base URL
    variables:
      base_url:
        default: https://sandbox.zapyd.com
security:
  - ApiKeyAuth: []
    TimestampAuth: []
    SignatureAuth: []
tags:
  - name: Customer
    description: Customer related operations
    x-displayName: Customer
    x-traitTag: true
  - name: Payout
    description: Payout related operations
  - name: Webhooks
    description: Webhook related operations
  - name: Widget
    description: Hosted buy/sell widget session initialization
paths:
  /customer/wallet/{customer_id}/{wallet_id}/delete:
    delete:
      tags:
        - Wallet
      description: >-
        Delete one of a customer's wallets. Sign the request with an empty body
        (`{}`).
      parameters:
        - name: customer_id
          in: path
          required: true
          description: Customer's unique identifier
          schema:
            type: string
            format: uuid
          example: c2cf861b-342b-4318-a90e-85cd0312e82f
        - name: wallet_id
          in: path
          required: true
          description: Wallet ID returned by Add Wallet (integer)
          schema:
            type: integer
          example: 42
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Wallet deleted successfully
                  data:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: >-
                          Wallet ID (integer). Use it in the fetch and delete
                          paths.
                        example: 42
                      wallet_address:
                        type: string
                        description: Wallet address
                        example: '0x1234567890123456789012345678901234567890'
                      network:
                        type: string
                        description: Canonical network name
                        example: Ethereum
                        enum:
                          - Ethereum
                          - Polygon
                          - Arbitrum
                          - Bsc
                          - Sepolia
                          - Solana
                          - Tron
                      label:
                        type: string
                        description: >-
                          Label shown in the address book. Only labelled wallets
                          are returned by List Wallets.
                        example: Main wallet
                      status:
                        type: string
                        description: Wallet status
                        example: ACTIVE
                        enum:
                          - ACTIVE
                          - INACTIVE
                      is_visible:
                        type: boolean
                        description: True when the wallet has a non-empty label
                        example: true
                      created_at:
                        type: string
                        description: Creation time (ISO 8601)
                        example: '2026-09-30T10:00:00Z'
                        format: date-time
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Bad Request
                  data:
                    type: 'null'
                  errors:
                    type: object
                    example:
                      non_field_errors:
                        - Wallet not found.
                  err_code:
                    type: string
                    example: UNKNOWN_ERROR
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Internal Server Error
                  data:
                    type: 'null'
                  errors:
                    type: object
                    example: {}
                  err_code:
                    type: string
                    example: SYS_INTERNAL_ERROR
      servers:
        - url: https://sandbox.zapyd.com/cms/api/v1
          description: Customer API Base URL
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API Key for authentication
    TimestampAuth:
      type: apiKey
      in: header
      name: X-TIMESTAMP
      description: Current timestamp in seconds since epoch
    SignatureAuth:
      type: apiKey
      in: header
      name: X-SIGNATURE
      description: HMAC SHA256 signature of the request encoded in Base64

````