---
updatedAt: 2026-07-30T20:45:26.000Z
agentTools:
  projectIndex: https://nibo.readme.io/llms.txt
---

# Criar Pagamento (json)

Realiza um pagamento a um contato. Ao realizar o pagamento, será criado um agendamento e baixa com o valor pago.

**Exemplo do Corpo da Requisição**

A requisição deve incluir um JSON no corpo (body) com os seguintes campos:

```json json
{
    "accountId": "20dc5550-7cf3-4db9-9e57-c9357f83ebda",
    "stakeholderId": "8c29e7c8-99e0-44b6-b613-c154b7ca7680", 
    "date": "2024-08-06",
    "description": "Pagamento de Consultoria", 
    "reference": "Ref-20240806-01", 
    "isFlag": true,  
    "accrualDate": "2024-08-06", 
    "categories": [
        {
            "categoryid": "fd8441bb-a1d9-4546-bab2-fa1ad4b4812c",
            "value": 200.0,
            "description": "Serviços de Consultoria"
        }        
    ],
    "costcenters": [
        {
            "costcenterid": "236bd958-3aba-4a71-9e3d-443d6094a4b2",
            "percent": 100,
            "description": "Centro de Custo A"
        }        
    ]
}
```

**Observação**:

* **Se o rateio estiver habilitado,** poderá ser passado mais de uma categoria na lista de categories. Neste caso, cada item na lista representará uma parte do valor total, com a soma dos valores correspondendo ao valor total do recebimento.
* **Se o rateio não estiver habilitado**, você deve passar apenas uma categoria na lista de categories.
* A lista de costcenters funciona da mesma forma que a de categories: se o rateio estiver habilitado, poderá ser passado uma lista com vários centros de custo, especificando a porcentagem para cada um. Caso contrário, deve-se passar apenas um centro de custo na lista.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-empresa",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.nibo.com.br/empresas"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "apitoken",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/payments/FormatType=json": {
      "post": {
        "summary": "Criar Pagamento (json)",
        "description": "Realiza um pagamento a um contato. Ao realizar o pagamento, será criado um agendamento e baixa com o valor pago.",
        "operationId": "criar-pagamento-json",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "accountId",
                  "stakeholderId",
                  "date",
                  "categories"
                ],
                "properties": {
                  "accountId": {
                    "type": "string",
                    "description": "Identificador da conta para pagamento"
                  },
                  "stakeholderId": {
                    "type": "string",
                    "description": "Indentificador do contato(fornecedor, funcionário ou sócio) para o pagamento"
                  },
                  "date": {
                    "type": "string",
                    "description": "Data do pagamento",
                    "format": "date"
                  },
                  "categories": {
                    "type": "array",
                    "description": "Lista de categorias de saída",
                    "items": {
                      "properties": {
                        "categoryId": {
                          "type": "string",
                          "description": "Identificador da categoria"
                        },
                        "value": {
                          "type": "number",
                          "description": "Valor da categoria",
                          "format": "double"
                        },
                        "description": {
                          "type": "string",
                          "description": "Descrição da categoria"
                        }
                      },
                      "required": [
                        "categoryId",
                        "value"
                      ],
                      "type": "object"
                    }
                  },
                  "costcenters": {
                    "type": "array",
                    "description": "Lista de centros de custo",
                    "items": {
                      "properties": {
                        "costCenterId": {
                          "type": "string",
                          "description": "Identificador do centro de custo"
                        },
                        "percent": {
                          "type": "string",
                          "description": "Porcentagem do centro de custo"
                        }
                      },
                      "type": "object"
                    }
                  },
                  "description": {
                    "type": "string",
                    "description": "Descrição do pagamento"
                  },
                  "accrualDate": {
                    "type": "string",
                    "description": "Data de competência"
                  },
                  "reference": {
                    "type": "string",
                    "description": "Referência"
                  },
                  "isFlag": {
                    "type": "boolean",
                    "description": "Habilitar agendamento como favorito"
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "accountId": "string",
                    "stakeholderId": "string",
                    "date": "yyyy-mm-dd",
                    "accrualDate": "yyyy-mm-dd",
                    "description": "string",
                    "reference": "string",
                    "isFlag": true,
                    "categories": [
                      {
                        "categoryId": "string",
                        "value": 0.1,
                        "description": "string"
                      }
                    ],
                    "costCenters": [
                      {
                        "costCenterId": "string",
                        "percent": 100,
                        "description": "string"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"entryId\": \"string\",\n    \"bankBalanceDateIsGreaterThanEntryDate\": false,\n    \"scheduleId\": \"string\",\n    \"isVirtual\": false,\n    \"account\": {\n        \"id\": \"string\",\n        \"name\": \"string\",\n        \"isDeleted\": false\n    },\n    \"stakeholder\": {\n        \"id\": \"string\",\n        \"name\": \"string\",\n        \"isDeleted\": false\n    },\n    \"category\": {\n        \"id\": \"string\",\n        \"name\": \"string\",\n        \"isDeleted\": false,\n        \"type\": \"out\"\n    },\n    \"categories\": [\n        {\n            \"id\": \"string\",\n            \"categoryId\": \"string\",\n            \"categoryName\": \"string\",\n            \"value\": 200.0,\n            \"description\": \"string\",\n            \"type\": \"string\",\n            \"parent\": \"string\",\n            \"parentId\": \"string\"\n        }\n    ],\n    \"date\": \"string\",\n    \"identifier\": \"string\",\n    \"value\": 200.0,\n    \"description\": \"string\",\n    \"isReconciliated\": false,\n    \"isTransfer\": false,\n    \"isFlagged\": false,\n    \"costCenter\": {\n        \"costCenterId\": \"string\",\n        \"description\": \"string\"\n    },\n    \"costCenters\": [\n        {\n            \"costCenterId\": \"string\",\n            \"percent\": 100.0,\n            \"value\": -200.0,\n            \"costCenterDescription\": \"string\"\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "entryId": {
                      "type": "string",
                      "example": "string"
                    },
                    "bankBalanceDateIsGreaterThanEntryDate": {
                      "type": "boolean",
                      "example": false,
                      "default": true
                    },
                    "scheduleId": {
                      "type": "string",
                      "example": "string"
                    },
                    "isVirtual": {
                      "type": "boolean",
                      "example": false,
                      "default": true
                    },
                    "account": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "string"
                        },
                        "name": {
                          "type": "string",
                          "example": "string"
                        },
                        "isDeleted": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        }
                      }
                    },
                    "stakeholder": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "string"
                        },
                        "name": {
                          "type": "string",
                          "example": "string"
                        },
                        "isDeleted": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        }
                      }
                    },
                    "category": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "string"
                        },
                        "name": {
                          "type": "string",
                          "example": "string"
                        },
                        "isDeleted": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "type": {
                          "type": "string",
                          "example": "out"
                        }
                      }
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "string"
                          },
                          "categoryId": {
                            "type": "string",
                            "example": "string"
                          },
                          "categoryName": {
                            "type": "string",
                            "example": "string"
                          },
                          "value": {
                            "type": "integer",
                            "example": 200,
                            "default": 0
                          },
                          "description": {
                            "type": "string",
                            "example": "string"
                          },
                          "type": {
                            "type": "string",
                            "example": "string"
                          },
                          "parent": {
                            "type": "string",
                            "example": "string"
                          },
                          "parentId": {
                            "type": "string",
                            "example": "string"
                          }
                        }
                      }
                    },
                    "date": {
                      "type": "string",
                      "example": "string"
                    },
                    "identifier": {
                      "type": "string",
                      "example": "string"
                    },
                    "value": {
                      "type": "integer",
                      "example": 200,
                      "default": 0
                    },
                    "description": {
                      "type": "string",
                      "example": "string"
                    },
                    "isReconciliated": {
                      "type": "boolean",
                      "example": false,
                      "default": true
                    },
                    "isTransfer": {
                      "type": "boolean",
                      "example": false,
                      "default": true
                    },
                    "isFlagged": {
                      "type": "boolean",
                      "example": false,
                      "default": true
                    },
                    "costCenter": {
                      "type": "object",
                      "properties": {
                        "costCenterId": {
                          "type": "string",
                          "example": "string"
                        },
                        "description": {
                          "type": "string",
                          "example": "string"
                        }
                      }
                    },
                    "costCenters": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "costCenterId": {
                            "type": "string",
                            "example": "string"
                          },
                          "percent": {
                            "type": "integer",
                            "example": 100,
                            "default": 0
                          },
                          "value": {
                            "type": "integer",
                            "example": -200,
                            "default": 0
                          },
                          "costCenterDescription": {
                            "type": "string",
                            "example": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "500",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"error\": \"string\",\n  \"error_description\": \"string\",\n  \"exception\": {\n    \"ClassName\": \"string\",\n    \"Message\": \"string\",\n    \"Data\": null,\n    \"InnerException\": null,\n    \"HelpURL\": null,\n    \"StackTraceString\": \"string\",\n    \"RemoteStackTraceString\": null,\n    \"RemoteStackIndex\": 0,\n    \"ExceptionMethod\": \"string\",\n    \"HResult\": 0,\n    \n    \"WatsonBuckets\": null\n  }\n}\n"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "string"
                    },
                    "error_description": {
                      "type": "string",
                      "example": "string"
                    },
                    "exception": {
                      "type": "object",
                      "properties": {
                        "ClassName": {
                          "type": "string",
                          "example": "string"
                        },
                        "Message": {
                          "type": "string",
                          "example": "string"
                        },
                        "Data": {},
                        "InnerException": {},
                        "HelpURL": {},
                        "StackTraceString": {
                          "type": "string",
                          "example": "string"
                        },
                        "RemoteStackTraceString": {},
                        "RemoteStackIndex": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        },
                        "ExceptionMethod": {
                          "type": "string",
                          "example": "string"
                        },
                        "HResult": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        },
                        "WatsonBuckets": {}
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```