---
title: "Create advancement request (outdated)"
method: POST
path: "/v2/merchants/{merchantId}/advancements"
tags: ["Merchant advancement"]
---

# Create advancement request (outdated)

`POST /v2/merchants/{merchantId}/advancements`

## Request

- Base URL: `https://sandbox.pismolabs.io/merchants`
- URL: `https://sandbox.pismolabs.io/merchants/v2/merchants/{merchantId}/advancements`
- Auth: HTTP bearer

Create advancement request for merchant. An advancement is the same as an anticipation of receivables or a prepayment of receivables. An example of a
situation in which a seller might use advancements is if it has a deal with a large customer who it knows is going to take some time to pay its bills.
To cover its business expenses in the meantime, the seller could make a deal with a bank to pay it for the goods sold at the time of sale. The seller later
repays the bank when it gets paid by its customer. The bank profits because the seller pays a fee for each advancement.<br>
This endpoint produces a [Merchant advancement request created](https://developers.pismo.io/events/docs/merchants-advancement-request-1) event.

(<strong>Outdated:</strong> For an updated version of the advancement endpoint refer to [Advancement Request](https://developers.pismo.io/pismo-docs/reference/merchants-advancements).)

## Path parameters

- `merchantId` integer, required

## Headers

- `Content-Type` string
- `Authorization` string

## Request body

- POSTAdvancementRequest
  - `begin_date` string, required: Begin date (DD/MM/YYYY)
  - `amount` number, float, required: Advancement amount
  - `request_date` string: Request date (DD/MM/YYYY)
  - `end_date` string: End date (DD/MM/YYYY)
  - `notify` string: URL that receives notification
  - `real_time_settlement` boolean: Indicates whether transaction is settled in real time.

## Response `201`

OK

- AdvancementRequestResponse
  - `advancement_request_id` integer: Advancement request ID
  - `date_of_request` string, datetime: The date and time the advancement is requested. Note that the date and time are displayed in UTC format `yyyy-MM-ddThh:mm:ssZ`.
  - `amount_requested` string: Amount requested
  - `begin_date` string: Begin date (DD/MM/YYYY)
  - `end_date` string: End date (DD/MM/YYYY)
  - `advancement_fee` string: Advancement fee for creditor.
  - `discount_rate` string: Advancement discount rate for creditor.
  - `maximum_advancement_percentage` string: Maximum advancement percentage for creditor.
  - `interest_method` 'SIMPLE' | 'COMPOUND' | 'SIMPLIFIED': Advancement interest mode
  - `schedule_payment_date_update_mode` 'KEEP_FUTURE_DATES' | 'UPDATE_TO_NOW': Mode for updating advancement schedule payment date
  - `status` 'PENDING' | 'PROCESSED' | 'ERROR': Advancement status
  - `message` string: Feedback message for advancement request
  - `notify` string: URL that receives notification
  - `advanced_gross_amount` number: Gross amount advanced
  - `advanced_discount_amount` number, float: AdvancementDiscountAmount
  - `advanced_net_amount` number: Net amount advanced

## Other responses

- `400`: Bad Request
- `401`: Access token is missing or invalid
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/seller-management-merchants.md) - [All operations](https://skmtc.dev/pismo/apis/seller-management-merchants/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/seller-management-merchants/revisions/f0c2e31fbbc0?raw)