> ## Documentation Index > Fetch the complete documentation index at: https://docs.synctera.com/llms.txt > Use this file to discover all available pages before exploring further. # Update 3DS Decision Gateway > Update 3DS Decision Gateway ## OpenAPI ````yaml openapi-v1.json patch /cards/three_ds_decision_gateways/{id} openapi: 3.0.3 info: description: >- This is the official reference documentation for Synctera APIs. If you need something specific or have a question, contact us.

license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html title: Synctera API version: 1.191.0 servers: - description: Production url: https://api.synctera.com/v1 - description: Sandbox (no real world financial impact) url: https://api-sandbox.synctera.com/v1 security: - bearerAuth: [] tags: - description: | Requests to create and manage Rewards name: Rewards (beta) - description: Requests to generate simulated webhooks name: Card Webhook Simulations - description: >- Testing endpoints to simulate in-store cash deposits. Available in sandbox environments only. name: In-Store Cash Deposit Simulations - description: Create and manage spending controls name: Spend Controls (beta) - description: Rates name: Rates - description: Requests to create and manage webhooks name: Webhooks - description: Tenant Config name: Tenant Config - description: FDX authentication and data transfer using Plaid Core Exchange name: Plaid Core Exchange (beta) - description: Create and manage disputes name: Disputes - description: Requests to simulate card payments name: Card Simulations - description: >- Aggregated write-off amounts for lending accounts, computed from posted transactions. name: Write Off Amounts - description: | Manage fee products and fee configs for automated fee collection name: Fee Products - description: Apple Pay APIs name: Apple Pay - description: Lending Config name: Lending Config - description: Payments related to lending accounts name: Payments - description: Manage negative balance processes name: Negative Balance - description: Configuration for mapping LoanPro events to Payola transaction parameters name: LoanPro Transaction Event Config - description: Requests to generate simulated transactions name: Cash Transaction Simulations (alpha) - description: Create and manage transactions name: Transactions (beta) - description: Autopay payment records for billing periods name: Autopays - description: Create and manage accounts name: Accounts - description: | Requests to create and manage batch payments name: Batch Payments (alpha) - description: Billing rates name: Billing Rates - description: Bank Delinquency Configuration name: Bank Delinquency Configuration - description: >- Rules that map a posted payment transaction (bank/partner + transaction attributes) to a regulatory payment code. NULL match columns act as wildcards. name: Payment Code Configuration - description: Create and manage Synctera Pay templates name: SyncteraPay - description: | Manage reward products and reward configs for automated cashback rewards name: Reward Products - description: Requests to create and manage card disputes name: Card Disputes - description: >- Per bank/partner account-type mapping to FFIEC collateral codes used for regulatory call report furnishment. name: Collateral Code Configuration - description: Bulk card issuance name: Bulk Issuance - description: Autopay configuration management for lending accounts name: Autopay Configs - description: Request to create and manage exclusions name: Statements - description: Create and manage barcodes for in-store cash deposits name: In-Store Cash Deposits - description: Customer Service Details for disputes and billing inquiries name: Customer Service Details - description: Create a credit application. name: Applications (beta) - description: Requests to generate simulated transactions name: Card Transaction Simulations - description: Billing period summaries name: Billing Period Summaries - description: Requests to issue and manage cards name: Cards - description: Push and pull from cards name: External Cards - description: | Requests to create and manage fees name: Fees (beta) paths: /cards/three_ds_decision_gateways/{id}: summary: 3DS Decision Gateways description: > 3DS Decision Gateways define endpoints to which the Synctera platform will send 3DS decision requests, allowing the integrator to make 3DS decisions on a per-transaction basis. patch: tags: - Cards summary: Update 3DS Decision Gateway description: | Update 3DS Decision Gateway operationId: updateThreeDsGateway parameters: - $ref: '#/components/parameters/three_ds_decision_gateway_id' - $ref: '#/components/parameters/idempotency_key' requestBody: content: application/json: schema: $ref: '#/components/schemas/update_three_ds_decision_gateway_request' description: Updated 3DS Decision Gateway fields required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/three_ds_decision_gateway_response' description: The updated 3DS Decision Gateway Updated '400': $ref: '#/components/responses/bad_request' '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '422': $ref: '#/components/responses/unprocessable_entity' '500': $ref: '#/components/responses/internal_server_error' components: parameters: three_ds_decision_gateway_id: in: path name: id required: true schema: $ref: '#/components/schemas/three_ds_decision_gateway_id' idempotency_key: description: >- An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry. in: header name: Idempotency-Key schema: example: 7d943c51-e4ff-4e57-9558-08cab6b963c7 type: string schemas: update_three_ds_decision_gateway_request: properties: card_products: description: > List of card product unique IDs that will use the 3DS decision gateway. Note that the list of card product IDs from this request does not merge with the 3DS gateway's previous list of card product IDs. The list of card product IDs for the gateway will be fully replaced by the list from the update request, if any such list is included in the request. items: example: 7d943c51-e4ff-4e57-9558-08cab6b963c7 format: uuid type: string type: array custom_headers: $ref: '#/components/schemas/gateway_custom_headers' decision_url: description: URL of the 3DS decision gateway format: uri maxLength: 1000 type: string fallback_decision: $ref: '#/components/schemas/three_ds_decision' is_active: description: The 3DS decision gateway will only be used if this is true. type: boolean type: object three_ds_decision_gateway_response: properties: card_products: description: List of Card Product IDs that will use the 3DS decision gateway items: example: 29346ae3-6481-48c0-ada4-13a60f2d1bd1 format: uuid type: string type: array creation_time: description: The timestamp when the 3DS decision gateway was created example: '2010-05-06T12:23:34.321Z' format: date-time readOnly: true type: string custom_headers: $ref: '#/components/schemas/gateway_custom_headers' decision_url: description: URL of the 3DS decision gateway format: uri maxLength: 1000 type: string fallback_decision: $ref: '#/components/schemas/three_ds_decision' id: $ref: '#/components/schemas/three_ds_decision_gateway_id' is_active: description: The 3DS decision gateway will only be used if this is true. type: boolean last_updated_time: description: The timestamp when the 3DS decision gateway was last modified example: '2010-05-06T12:23:34.321Z' format: date-time readOnly: true type: string tenant: $ref: '#/components/schemas/tenant_id' required: - card_products - creation_time - decision_url - fallback_decision - id - is_active - last_updated_time - tenant type: object three_ds_decision_gateway_id: description: The unique identifier of an 3DS decision gateway format: uuid type: string gateway_custom_headers: additionalProperties: type: string description: > These key-value pairs define custom HTTP headers that will be included in every HTTP request to the gateway. Note that when updating this field, all key-value pairs will be replaced. They are not merged with existing data. type: object three_ds_decision: description: > Possible decision responses when faced with a EMV 3-D Secure transaction. Policy | Description ---------------- | ----------- SMS_OTP | Use the card holder's phone number on file to perform advanced authentication via SMS EXEMPT | Transactions will be exempted from advanced authentication enum: - EXEMPT - SMS_OTP type: string tenant_id: description: | The id of the tenant containing the resource. example: abcdef_ghijkl type: string error: description: Synctera error responses in API v1 implement a custom error schema. properties: code: description: > A machine-readable string that identifies the error for programmatic use. example: BAD_REQUEST_BODY type: string detail: description: | A human-readable string explaining this particular error. example: 'Missing required fields: first_name, dob' type: string status: description: HTTP status code for this response example: 400 type: integer title: Synctera error response type: object responses: bad_request: content: application/json: schema: $ref: '#/components/schemas/error' description: Bad request unauthorized: content: application/json: schema: $ref: '#/components/schemas/error' description: Unauthorized forbidden: content: application/json: schema: $ref: '#/components/schemas/error' description: Forbidden unprocessable_entity: content: application/json: schema: $ref: '#/components/schemas/error' description: Unprocessable entity internal_server_error: content: application/json: schema: $ref: '#/components/schemas/error' description: Internal server error securitySchemes: bearerAuth: bearerFormat: api_key scheme: bearer type: http ````