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

# Update processor

> Update an existing processor configuration (name, credentials, currencies, enabled status). Requires org:admin role.



## OpenAPI

````yaml /openapi.json post /api/public/v1/processors/update
openapi: 3.0.3
info:
  title: TagadaPay API
  description: >-

    # TagadaPay API Documentation


    Welcome to the TagadaPay API. This REST API lets you process payments,
    manage subscriptions, handle customers, deploy plugins, and orchestrate
    checkout funnels — all programmatically.


    ## Authentication


    Authenticate every request with a Bearer token. Get your API key from the
    [TagadaPay Dashboard](https://app.tagada.io).


    ```

    Authorization: Bearer your-api-key

    ```


    All requests must be made over HTTPS with `Content-Type: application/json`.


    ## Rate Limits


    | Plan | Requests/min | Burst |

    |------|-------------|-------|

    | Standard | 100 | 150 |

    | Premium | 500 | 750 |


    Exceeding the limit returns `429 Too Many Requests`.


    ## Errors


    | Code | Meaning |

    |------|---------|

    | 400 | Bad request — invalid parameters |

    | 401 | Unauthorized — missing or invalid API key |

    | 403 | Forbidden — insufficient permissions |

    | 404 | Not found |

    | 409 | Conflict |

    | 429 | Rate limited |

    | 500 | Server error |


    ## Support


    - Email: api-support@tagada.io

    - Docs: [docs.tagadapay.com](https://docs.tagadapay.com)
        
  version: 1.0.0
servers:
  - url: https://api.tagada.io/
    description: Production
  - url: https://api.tagada.dev/
    description: Sandbox / Development
security:
  - bearerAuth: []
tags:
  - name: auth
    description: Test your API key and verify authentication.
  - name: stores
    description: Create and manage stores within your account.
  - name: products
    description: Create products with variants, prices, and currency options.
  - name: customers
    description: Manage customer records, addresses, and payment instruments.
  - name: orders
    description: List and retrieve orders with line items, payments, and metadata.
  - name: payments
    description: Process, list, refund, void, and dispute payments.
  - name: subscriptions
    description: >-
      Create and manage recurring subscriptions — billing, cancellation,
      rebilling, and processor changes.
  - name: payment-flows
    description: Configure payment routing strategies with cascading processor fallbacks.
  - name: payment-instruments
    description: >-
      Manage stored payment methods — cards, bank accounts, and tokenized
      instruments.
  - name: processors
    description: List connected payment processors (Stripe, NMI, Checkout.com, etc.).
  - name: promotions
    description: Create and manage discount promotions with rules and conditions.
  - name: promotion-codes
    description: Generate and manage reusable promotion/coupon codes.
  - name: block-rules
    description: >-
      Configure fraud prevention rules to block transactions by IP, email, card
      BIN, country, etc.
  - name: webhooks
    description: Register webhook endpoints to receive real-time event notifications.
  - name: events
    description: Query application events, statistics, and audit logs.
  - name: domains
    description: Add, verify, and manage custom domains for your checkout and funnels.
  - name: funnels
    description: >-
      Create and manage checkout funnels with routing, A/B testing, and CDN
      deployment.
  - name: funnel-sessions
    description: Retrieve funnel session data for analytics and debugging.
  - name: funnel-tracking
    description: Track funnel step events for conversion analytics.
  - name: plugins
    description: Deploy, manage, and configure checkout plugins.
  - name: plugins-v2
    description: >-
      V2 plugin system — deploy, mount, split-test, fork, promote, and manage
      plugin instances.
  - name: checkout
    description: >-
      Initialize checkout sessions and process payments through the hosted
      checkout.
  - name: 3ds
    description: >-
      3D Secure authentication — create sessions, authenticate, and handle
      challenges.
  - name: builder
    description: Generate and validate builder session tokens for the visual page editor.
  - name: health
    description: API health check endpoint.
  - name: test
    description: Test and debugging utilities for the event system (sandbox only).
paths:
  /api/public/v1/processors/update:
    post:
      tags:
        - processors
      summary: Update processor
      description: >-
        Update an existing processor configuration (name, credentials,
        currencies, enabled status). Requires org:admin role.
      operationId: post-api-public-v1-processors-update
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                processorId:
                  type: string
                updatedData:
                  type: object
                  properties:
                    name:
                      type: string
                    type:
                      type: string
                    enabled:
                      type: boolean
                    supportedCurrencies:
                      type: array
                      items:
                        type: string
                    baseCurrency:
                      type: string
                    monthlyProcessingCapacity:
                      type: number
                    totalProcessedAmount:
                      type: number
                    approvalRate:
                      type: number
                    monthlyApprovalRate:
                      type: number
                    options:
                      type: object
                      properties:
                        secretKey:
                          type: string
                        publicKey:
                          type: string
                        webhookSecret:
                          type: string
                        sendReceiptEmail:
                          type: boolean
                        apiKey:
                          type: string
                        username:
                          type: string
                        password:
                          type: string
                        websiteKey:
                          type: string
                        secretKeyPos:
                          type: string
                        merchantId:
                          type: string
                        gatewayUrl:
                          type: string
                        apiVersion:
                          type: string
                        clientId:
                          type: string
                        clientSecret:
                          type: string
                        clientApiKey:
                          type: string
                        sellerCode:
                          type: string
                        apiSecretKey:
                          type: string
                        notifyUrl:
                          type: string
                        appId:
                          type: string
                        forceDecline:
                          type: boolean
                        targetApprovalRate:
                          type: number
                        testMode:
                          type: boolean
                        connectionState:
                          type: string
                          enum:
                            - pending
                            - connected
                            - disconnected
                        returnUrl:
                          type: string
                        storeId:
                          type: string
                        accountId:
                          type: string
                        useProcessorToken:
                          type: boolean
                        descriptor:
                          type: object
                          properties:
                            descriptor:
                              type: string
                            descriptor_suffix:
                              type: string
                            phone:
                              type: string
                            address:
                              type: string
                            city:
                              type: string
                            state:
                              type: string
                            postal:
                              type: string
                            country:
                              type: string
                            mcc:
                              type: string
                            merchantId:
                              type: string
                            url:
                              type: string
                          additionalProperties: false
                        sandboxed:
                          type: boolean
                        enable3DS:
                          type: boolean
                        merchantName:
                          type: string
                        merchantUrl:
                          type: string
                        merchantCountryCode:
                          type: string
                        amexRequestorType:
                          type: string
                        cbSiretNumber:
                          type: string
                        discoverClientId:
                          type: string
                        acquirerBinVisa:
                          type: string
                        acquirerBinMastercard:
                          type: string
                        acquirerBinAmex:
                          type: string
                        acquirerBinDiscover:
                          type: string
                        acquirerBinJcb:
                          type: string
                        acquirerBinDinersClub:
                          type: string
                        acquirerBinCB:
                          type: string
                        outlet:
                          type: string
                          minLength: 1
                        apiUrl:
                          anyOf:
                            - type: string
                              format: uri
                              pattern: '[a-z]$'
                            - type: string
                              enum:
                                - ''
                        accessCode:
                          type: string
                        workingKey:
                          type: string
                        apiLoginId:
                          type: string
                        transactionKey:
                          type: string
                        clientKey:
                          type: string
                        merchantAccount:
                          type: string
                        hmacKey:
                          type: string
                        liveEndpointPrefix:
                          type: string
                        balanceAccountId:
                          type: string
                        integrationName:
                          type: string
                        radar:
                          type: object
                          properties:
                            enabled:
                              type: boolean
                            publishableKey:
                              type: string
                          additionalProperties: false
                        tagadapayAccountId:
                          type: string
                        statementDescriptor:
                          type: string
                        userId:
                          type: string
                        dryMode:
                          type: boolean
                        expressPublishableKey:
                          type: string
                        apmSettings:
                          type: object
                          additionalProperties:
                            type: object
                            properties:
                              enabled:
                                type: boolean
                              label:
                                type: string
                              description:
                                type: string
                              supportedCountries:
                                type: array
                                items:
                                  type: string
                              presentmentCurrencies:
                                type: array
                                items:
                                  type: string
                              logoUrl:
                                type: string
                              recurring:
                                type: boolean
                              isExpress:
                                type: boolean
                            additionalProperties: false
                      additionalProperties: false
                  required:
                    - name
                    - type
                  additionalProperties: false
              required:
                - processorId
                - updatedData
              additionalProperties: false
            examples:
              basic:
                summary: Update name and currencies
                value:
                  processorId: processor_abc123
                  updatedData:
                    name: Stripe EU
                    type: stripe
                    supportedCurrencies:
                      - EUR
                      - GBP
                      - CHF
                    baseCurrency: EUR
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema: {}
        default:
          $ref: '#/components/responses/error'
      security:
        - bearerAuth: []
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Enter your API key as: `Bearer your-api-key`'

````