---
updatedAt: 2026-06-03T12:16:05.000Z
agentTools:
  projectIndex: https://docs.asaas.com/llms.txt
---

# Create new payment with summary data in response

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Asaas",
    "description": "API pública de integração com a plataforma Asaas.",
    "version": "3.0.0"
  },
  "servers": [
    {
      "url": "https://api-sandbox.asaas.com",
      "description": "Sandbox"
    }
  ],
  "security": [
    {
      "Authorization": []
    }
  ],
  "tags": [
    {
      "name": "Payment with summary data"
    }
  ],
  "paths": {
    "/v3/lean/payments": {
      "post": {
        "tags": [
          "Payment with summary data"
        ],
        "summary": "Create new payment with summary data in response",
        "description": "",
        "operationId": "create-new-payment-with-summary-data-in-response",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaymentSaveRequestDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentLeanGetResponseDTO"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDTO"
                },
                "example": {
                  "errors": [
                    {
                      "code": "invalid_customer",
                      "description": "Customer Inválido ou não informado"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDTO"
                },
                "example": {
                  "errors": [
                    {
                      "code": "invalid_access_token",
                      "description": "A chave de API fornecida é inválida"
                    }
                  ]
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorResponseDTO": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "description": "List of objects",
            "deprecated": false,
            "items": {
              "$ref": "#/components/schemas/ErrorResponseItemDTO"
            }
          }
        }
      },
      "ErrorResponseItemDTO": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error code",
            "deprecated": false,
            "example": null
          },
          "description": {
            "type": "string",
            "description": "Error description",
            "deprecated": false,
            "example": null
          }
        },
        "description": "List of objects",
        "deprecated": false
      },
      "PaymentDiscountDTO": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "description": "Percentage or fixed amount of discount to be applied to the Payment amount",
            "example": 10,
            "deprecated": false
          },
          "dueDateLimitDays": {
            "type": "integer",
            "description": "Days before expiration to apply discount. Ex: 0 = until expiration, 1 = up to one day before, 2 = up to 2 days before, and so on",
            "format": "int32",
            "example": 0,
            "deprecated": false
          },
          "type": {
            "$ref": "#/components/schemas/PaymentDiscountDiscountType"
          }
        },
        "description": "Discount information",
        "deprecated": false
      },
      "PaymentDiscountDiscountType": {
        "type": "string",
        "description": "Discount type",
        "example": "PERCENTAGE",
        "deprecated": false,
        "enum": [
          "FIXED",
          "PERCENTAGE"
        ]
      },
      "PaymentInterestRequestDTO": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "description": "Percentage of interest per month on the amount charged for payment after maturity",
            "deprecated": false,
            "example": null
          }
        },
        "description": "Interest information for payment after due date",
        "deprecated": false
      },
      "PaymentFineRequestDTO": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "description": "Percentage of fine on the amount of the charge for payment after the due date",
            "deprecated": false,
            "example": null
          },
          "type": {
            "$ref": "#/components/schemas/PaymentFineRequestFineType"
          }
        },
        "description": "Fine information for payment after due date",
        "deprecated": false
      },
      "PaymentFineRequestFineType": {
        "type": "string",
        "description": "Fine type",
        "example": "FIXED",
        "deprecated": false,
        "enum": [
          "FIXED",
          "PERCENTAGE"
        ]
      },
      "PaymentCallbackRequestDTO": {
        "required": [
          "successUrl"
        ],
        "type": "object",
        "properties": {
          "successUrl": {
            "maxLength": 255,
            "type": "string",
            "description": "URL that the customer will be redirected to after successful payment of the invoice or payment link",
            "nullable": false,
            "deprecated": false,
            "example": null
          },
          "autoRedirect": {
            "type": "boolean",
            "description": "Define whether the customer will be automatically redirected or will just be informed with a button to return to the website. The default is true, if you want to disable it, enter false",
            "deprecated": false,
            "example": null
          }
        },
        "description": "Automatic redirection information after the payment of the link payment",
        "deprecated": false
      },
      "PaymentFineResponseDTO": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "description": "Fine amount in percentage",
            "example": 1,
            "deprecated": false
          }
        },
        "description": "Fine information for payment after due date",
        "deprecated": false
      },
      "PaymentInterestResponseDTO": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "description": "Interest value in percentage",
            "example": 2,
            "deprecated": false
          }
        },
        "description": "Interest information for payment after due date",
        "deprecated": false
      },
      "PaymentSaveRequestDTO": {
        "required": [
          "customer",
          "billingType",
          "value",
          "dueDate"
        ],
        "type": "object",
        "properties": {
          "customer": {
            "type": "string",
            "description": "Unique customer identifier in Asaas",
            "nullable": false,
            "example": "cus_G7Dvo4iphUNk",
            "deprecated": false
          },
          "billingType": {
            "$ref": "#/components/schemas/PaymentSaveRequestBillingType"
          },
          "value": {
            "type": "number",
            "description": "Payment amount",
            "nullable": false,
            "example": 129.9,
            "deprecated": false
          },
          "dueDate": {
            "type": "string",
            "description": "Payment due date",
            "format": "date",
            "nullable": false,
            "example": "2017-06-10",
            "deprecated": false
          },
          "description": {
            "type": "string",
            "description": "Payment description (max. 500 characters)",
            "example": "Pedido 056984",
            "deprecated": false
          },
          "daysAfterDueDateToRegistrationCancellation": {
            "type": "integer",
            "description": "Days after registration cancellation deadline (only for bank slip)",
            "format": "int32",
            "example": 1,
            "deprecated": false
          },
          "externalReference": {
            "type": "string",
            "description": "Free search field",
            "example": "056984",
            "deprecated": false
          },
          "installmentCount": {
            "type": "integer",
            "description": "Number of installments (only in the case of installment payment)",
            "format": "int32",
            "deprecated": false,
            "example": null
          },
          "totalValue": {
            "type": "number",
            "description": "Enter the total amount of a charge that will be paid in installments (only in the case of an installment charge). If this field is sent, the installmentValue is not necessary, the calculation per installment will be automatic.",
            "deprecated": false,
            "example": null
          },
          "installmentValue": {
            "type": "number",
            "description": "Value of each installment (only in the case of installment payment). Send this field if you want to define the value of each installment.",
            "deprecated": false,
            "example": null
          },
          "discount": {
            "$ref": "#/components/schemas/PaymentDiscountDTO"
          },
          "interest": {
            "$ref": "#/components/schemas/PaymentInterestRequestDTO"
          },
          "fine": {
            "$ref": "#/components/schemas/PaymentFineRequestDTO"
          },
          "postalService": {
            "type": "boolean",
            "description": "Define whether the payment will be sent via post",
            "example": false,
            "deprecated": false
          },
          "split": {
            "type": "array",
            "description": "Split Settings",
            "deprecated": false,
            "items": {
              "$ref": "#/components/schemas/PaymentSplitRequestDTO"
            }
          },
          "callback": {
            "$ref": "#/components/schemas/PaymentCallbackRequestDTO"
          },
          "pixAutomaticAuthorizationId": {
            "type": "string",
            "description": "Unique identifier of the Pix Automatic authorization in Asaas",
            "example": "89060430-aceb-447c-a981-07ee15daf00c",
            "deprecated": false
          }
        }
      },
      "PaymentSaveRequestBillingType": {
        "type": "string",
        "description": "Payment billing type",
        "nullable": false,
        "example": "BOLETO",
        "deprecated": false,
        "enum": [
          "UNDEFINED",
          "BOLETO",
          "CREDIT_CARD",
          "PIX"
        ]
      },
      "PaymentSplitRequestDTO": {
        "required": [
          "walletId"
        ],
        "type": "object",
        "properties": {
          "walletId": {
            "type": "string",
            "description": "Asaas wallet identifier that will be transferred",
            "nullable": false,
            "deprecated": false,
            "example": null
          },
          "fixedValue": {
            "type": "number",
            "description": "Fixed amount to be transferred to the account when the payment is received",
            "deprecated": false,
            "example": null
          },
          "percentualValue": {
            "type": "number",
            "description": "Percentage of the net value of the charge to be transferred when received",
            "deprecated": false,
            "example": null
          },
          "totalFixedValue": {
            "type": "number",
            "description": "(Instalments only). Amount that will be split relative to the total amount that will be paid in installments.",
            "deprecated": false,
            "example": null
          },
          "externalReference": {
            "type": "string",
            "description": "Split identifier in your system",
            "deprecated": false,
            "example": null
          },
          "description": {
            "type": "string",
            "description": "Split description",
            "deprecated": false,
            "example": null
          }
        },
        "description": "Split Settings",
        "deprecated": false
      },
      "PaymentLeanGetResponseDTO": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "description": "Object type",
            "example": "payment",
            "deprecated": false
          },
          "id": {
            "type": "string",
            "description": "Unique payment identifier in Asaas",
            "example": "pay_080225913252",
            "deprecated": false
          },
          "dateCreated": {
            "type": "string",
            "description": "Payment creation date",
            "format": "date",
            "example": "2017-03-10",
            "deprecated": false
          },
          "customerId": {
            "type": "string",
            "description": "Unique identifier of the customer to whom the payment belongs",
            "example": "cus_G7Dvo4iphUNk",
            "deprecated": false
          },
          "subscriptionId": {
            "type": "string",
            "description": "Unique subscription identifier (when recurring billing)",
            "deprecated": false,
            "example": null
          },
          "installmentId": {
            "type": "string",
            "description": "Unique installment identifier (when billing in installments)",
            "deprecated": false,
            "example": null
          },
          "paymentLinkId": {
            "type": "string",
            "description": "Unique identifier of the payments link to which the payment belongs",
            "deprecated": false,
            "example": null
          },
          "value": {
            "type": "number",
            "description": "Payment amount",
            "example": 129.9,
            "deprecated": false
          },
          "netValue": {
            "type": "number",
            "description": "Net value of the charge after discounting the Asaas fee",
            "example": 124.9,
            "deprecated": false
          },
          "originalValue": {
            "type": "number",
            "description": "Original amount of charge (filled when paid with interest and fine)",
            "deprecated": false,
            "example": null
          },
          "interestValue": {
            "type": "number",
            "description": "Calculated amount of interest and fine that must be paid after the charge is due",
            "deprecated": false,
            "example": null
          },
          "description": {
            "type": "string",
            "description": "Description of the payment",
            "example": "Pedido 056984",
            "deprecated": false
          },
          "billingType": {
            "$ref": "#/components/schemas/PaymentLeanGetResponseBillingType"
          },
          "canBePaidAfterDueDate": {
            "type": "boolean",
            "description": "Informs whether the charge can be paid after the due date (Only for bank slip)",
            "example": true,
            "deprecated": false
          },
          "confirmedDate": {
            "type": "string",
            "description": "Billing confirmation date",
            "format": "date",
            "example": "2017-03-10",
            "deprecated": false
          },
          "pixTransactionId": {
            "type": "string",
            "description": "Unique identifier of the Pix transaction to which the payment belongs",
            "deprecated": false,
            "example": null
          },
          "status": {
            "$ref": "#/components/schemas/PaymentLeanGetResponsePaymentStatus"
          },
          "dueDate": {
            "type": "string",
            "description": "Payment due date",
            "format": "date",
            "example": "2017-06-10",
            "deprecated": false
          },
          "originalDueDate": {
            "type": "string",
            "description": "Original due date upon creation of the payment",
            "format": "date",
            "example": "2017-06-10",
            "deprecated": false
          },
          "paymentDate": {
            "type": "string",
            "description": "Payment date on Asaas",
            "format": "date",
            "deprecated": false,
            "example": null
          },
          "customerPaymentDate": {
            "type": "string",
            "description": "Date on which the customer paid the bank slip",
            "format": "date",
            "deprecated": false,
            "example": null
          },
          "installmentNumber": {
            "type": "integer",
            "description": "Parcel number",
            "format": "int32",
            "deprecated": false,
            "example": null
          },
          "externalReference": {
            "type": "string",
            "description": "Free search field",
            "example": "056984",
            "deprecated": false
          },
          "deleted": {
            "type": "boolean",
            "description": "Determines if the payment has been removed",
            "example": false,
            "deprecated": false
          },
          "anticipated": {
            "type": "boolean",
            "description": "Defines whether the charge was anticipated or is in the process of being anticipated",
            "example": false,
            "deprecated": false
          },
          "anticipable": {
            "type": "boolean",
            "description": "Determines whether the charge is anticipated",
            "example": false,
            "deprecated": false
          },
          "creditDate": {
            "type": "string",
            "description": "Billing Credit date",
            "example": "2017-03-10",
            "deprecated": false
          },
          "transactionReceiptUrl": {
            "type": "string",
            "description": "URL of proof of confirmation, receipt, reversal or removal",
            "deprecated": false,
            "example": null
          },
          "duplicatedPaymentId": {
            "type": "string",
            "description": "Duplicate billing identifier (if true)",
            "deprecated": false,
            "example": null
          },
          "discount": {
            "$ref": "#/components/schemas/PaymentDiscountDTO"
          },
          "fine": {
            "$ref": "#/components/schemas/PaymentFineResponseDTO"
          },
          "interest": {
            "$ref": "#/components/schemas/PaymentInterestResponseDTO"
          },
          "postalService": {
            "type": "boolean",
            "description": "Define whether the payment will be sent via post",
            "example": false,
            "deprecated": false
          },
          "threeDSecureChallengeUrl": {
            "type": "string",
            "description": "URL to which the cardholder must be redirected to complete the 3D Secure authentication challenge. Only returned when the authentication challenge is required by the card issuer",
            "deprecated": false,
            "example": null
          }
        }
      },
      "PaymentLeanGetResponseBillingType": {
        "type": "string",
        "description": "Payment billing type",
        "example": "BOLETO",
        "deprecated": false,
        "enum": [
          "UNDEFINED",
          "BOLETO",
          "CREDIT_CARD",
          "DEBIT_CARD",
          "TRANSFER",
          "DEPOSIT",
          "PIX"
        ]
      },
      "PaymentLeanGetResponsePaymentStatus": {
        "type": "string",
        "description": "Payment status",
        "example": "PENDING",
        "deprecated": false,
        "enum": [
          "PENDING",
          "RECEIVED",
          "CONFIRMED",
          "OVERDUE",
          "REFUNDED",
          "RECEIVED_IN_CASH",
          "REFUND_REQUESTED",
          "REFUND_IN_PROGRESS",
          "CHARGEBACK_REQUESTED",
          "CHARGEBACK_DISPUTE",
          "AWAITING_CHARGEBACK_REVERSAL",
          "DUNNING_REQUESTED",
          "DUNNING_RECEIVED",
          "AWAITING_RISK_ANALYSIS"
        ]
      }
    },
    "securitySchemes": {
      "Authorization": {
        "type": "apiKey",
        "name": "access_token",
        "in": "header"
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "User-Agent",
        "value": "NomeDaSuaAplicacao/1.0.0"
      }
    ]
  }
}
```

# Sibling pages

* [List payments with summary data](https://docs.asaas.com/reference/list-payments-with-summary-data.md)
* [Create new payment with credit card with summary data in response](https://docs.asaas.com/reference/create-new-payment-with-credit-card-with-summary-data-in-response.md)
* [Capture payment with Pre-Authorization with summary data in response](https://docs.asaas.com/reference/capture-payment-with-pre-authorization-with-summary-data-in-response.md)
* [Retrieve a single payment with summary data](https://docs.asaas.com/reference/retrieve-a-single-payment-with-summary-data.md)
* [Update existing payment with summary data in response](https://docs.asaas.com/reference/update-existing-payment-with-summary-data-in-response.md)
* [Delete payment with summary data](https://docs.asaas.com/reference/delete-payment-with-summary-data.md)
* [Restore removed payment with summary data in response](https://docs.asaas.com/reference/restore-removed-payment-with-summary-data-in-response.md)
* [Refund payment with summary data in response](https://docs.asaas.com/reference/refund-payment-with-summary-data-in-response.md)
* [Confirm cash receipt with summary data in response](https://docs.asaas.com/reference/confirm-cash-receipt-with-summary-data-in-response.md)
* [Undo cash receipt confirmation with summary data in response](https://docs.asaas.com/reference/undo-cash-receipt-confirmation-with-summary-data-in-response.md)