---
title: "Submit a business response"
method: POST
path: "/v1/transactions/response"
tags: ["Transactions"]
---

# Submit a business response

`POST /v1/transactions/response`

## Request

- The document declares no server URL.
- Auth: API key in header `Ocp-Apim-Subscription-Key`

Submit a business response to a previously received transaction.

Business response must reference the transaction you want to respond to.

Use /response endpoint to submit a business response.

## Request body

- TransactionBusinessResponseRequest
  - `country_code` string: ISO 3166-1 alpha-2 uppercase country code the transaction is taking place in. Validations: - The /transactions/response endpoint is not supported for this country.
  - `note` string: A text note attached to a transaction. Notes are HTML enabled and will be displayed on the visual document. Validations: - Maximum length: 3000
  - `reference_transaction_id` string, required: The external transaction identifier of the original transaction the response is referencing. e.g., MY_ORIGINAL_IDENTIFIER_0001 Validations: - Maximum length: 150 - Required property
  - `tax_reason` TransactionTaxReason, required
    - `code` string, required: The specific code to be used as the tax reason for the transaction. e.g., S01 - indicating no tax effect in Mexican jurisdiction Validations: - Maximum length: 15 - Required property
    - `description` string: Further explanation of the tax reason for the code provided Validations: - Maximum length: 450
    - `tax_reason_details` TransactionTaxReasonDetail[]: Additional details to be provided for the tax reason code. Validations: - This field is only supported in specific use cases, refer to country-specific integration guides in the Fonoa dashboard.
      - `code` string: Additional code that complements the tax reason code. For example, specific refusal code for refusal tax reason. Validations: - Maximum length: 30
      - `note` string: Further explanation of the tax reason detail for the code provided Validations: - Maximum length: 450
  - `transaction_date` string, required: RFC3339 datetime string representing the point in time when transaction is executed. Validations: - Required property - Must be an RFC3339 format date
  - `transaction_id` string, required: External transaction identifier provided by the customer. e.g., MY_RESPONSE_IDENTIFIER_0001 Validations: - Maximum length: 150 - Required property

## Response `202`

Accepted - business response was successfully submitted for processing.

- OperationResultResponse
  - `errors` TransactionErrorResponse[]: List of errors in case the request was unsuccessful.
    - `code` string: Error code of the issue. e.g., field_not_valid
    - `doc_link` string: The link for the error documentation. Follow it to gather more details about the error
    - `field` string: Field from the input request that caused the error, in case of validation errors. e.g. transaction_date
    - `message` string: Error message of the issue. e.g., Date must be in RFC3339 format.
    - `type` string: Error type of the issue. e.g., warning, validation, general, tax_authority
  - `message` string: Information about the failure reason in case the request was unsuccessful.
  - `operation_id` string: Auto-generated unique identifier of a transaction operation returned upon async operation request.
  - `transaction_id` string: The unique external transaction identifier provided with the initial request.

## Other responses

- `400`: Bad customer request - some of the provided information is incorrect or mandatory data is missing. Check the message and errors section of the response for more details.
- `401`: Authentication failed - missing or incorrect subscription key
- `429`: Too many requests were sent for a short period of time. Try again a bit later.
- `5XX`: Internal server error. Its not you, its us! We are experiencing a rare and unexpected system disruption. Retry again later. The message field of the response will contain more information for the cause. Feel free to contact us.

---

[API](https://skmtc.dev/fonoa/apis/fonoa-e-invoicing.md) - [All operations](https://skmtc.dev/fonoa/apis/fonoa-e-invoicing/llms.txt) - [OpenAPI document](https://skmtc.dev/fonoa/apis/fonoa-e-invoicing/revisions/d38890cb6fcd?raw)