---
title: "Get invoice payment link"
method: POST
path: "/v3/invoices/{invoiceId}/payment-link"
tags: ["invoices"]
---

# Get invoice payment link

`POST /v3/invoices/{invoiceId}/payment-link`

Get an invoice payment link. In the response, BILL sends you a payment link based on the provided invoice and customer information.

You can send the invoice payment link to your customer for getting paid by the customer. With this link, the customer can complete the invoice payment without the need to set up a BILL account.

When a customer payment is made with the invoice payment link, BILL sends a payment receipt to the provided email address.

**Note**: You get valid invoice payment links only for customers that are NOT connected with your organization in the BILL network.

See [Invoices](https://developer.bill.com/docs/ar-invoices) in the Guides section for more information, sample requests, and responses.

## Path parameters

- `invoiceId` string, required — BILL-generated ID of the invoice. The value begins with `00e`.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Request body

- InvoicePaymentLinkRequestDto — Get invoice payment link
  - `customerId` string, required — BILL-generated ID of the customer. The value begins with `0cu`.
  - `email` string, required — Recipient email address. When a customer payment is made with the invoice payment link, BILL sends a payment receipt to the provided email address.
  - `returnUrl` string — Redirect URL after the customer payment is complete

## Response `200`

Get an invoice payment link response

- InvoicePaymentLinkResponseDto — Invoice Payment Link Response Dto.
  - `paymentLink` string — Invoice payment link

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)