# Shares a payment link POST {{baseURL}}/v2/payment-links/{{paymentLinkId}}/share This endpoint shares a payment link with a customer by SMS or email. This sends the link's URL to the recipient over the selected channel. Only `Active` links can be shared, and the customer must have consented to receive the message. This endpoint is Idempotent. See the `idempotency-key` header entry. For more information, see Idempotency. This endpoint requires a merchant API token. A partner API token will result in a permissions error including possibly a 403 response. See Also: To list payment links, see GET /v2/payment-links. To create a new payment link, see POST /v2/payment-links. To retrieve a payment link by identifier, see GET /v2/payment-links/{{paymentLinkId}}. To update a payment link, see PATCH /v2/payment-links/{{paymentLinkId}}. Endpoint: POST /v2/payment-links/{paymentLinkId}/share Version: V2 Beta Security: Bearer ## Security: - `Bearer` (unknown) http bearer JWT ## Path parameters: - `paymentLinkId` (string, required) Specifies the payment link identifier. Example: 6f2a8b3c-9d4e-4f1a-8b7c-3e5d6a9f0c1b ## Header parameters: - `idempotency-key` (string) Specifies the client-generated `idempotency-key`. This key is optional. We recommend using the key to prevent multiple invocations of the operation. This key makes this request safely retryable, or idempotent. If the idempotency key is not included, the call will not have idempotency protection. A retry with the same key, made within the retention window, returns the original response verbatim. The operation is not repeated. The retention window, also called the TTL (time to live) is 1440 minutes (24 hours) by default but this setting may be changed. A retry with the same key while the original request is still processing returns `409 Conflict` (`IdempotencyKeyInProgress`). Retry again after a short delay. Reusing the same key with a different request body returns `422 Unprocessable Content` (`IdempotencyKeyConflict`). Generate a new key for each distinct operation. A `500` series server error is not stored against the key. A retry with the same key after a `500` series response processes the request again. ## Request body: - `application/json` (unknown) Delivery channel, recipient, and customer consent. ## Request fields (application/json): - `shareBy` (string, required) Indicates the delivery method used to share a payment link with a customer. Valid values are: | Value | Description | | --- | --- | | Email | The link is sent by email. | | Sms | The link is sent by text message. | Example: Sms Enum: "Email", "Sms" - `recipient` (string, required) Specifies where the link is sent. This is a mobile phone number (in an E.164 format) when sharing by `Sms`. This is an email address when sharing by `Email`. Example: +14125553845 Example: +14125553845 - `hasCustomerConsent` (boolean, required) Specifies the customer has consented to receive the message. If `true`, the customer has consented to receive the message. If `false`, the customer has not consented to receive the message. Example: true Example: true ## Response 204: - `204` (unknown) No Content. The payment link was successfully shared. ## Response 400: - `400` (unknown) Bad Request ## Response 400 fields (application/json): - `details` (string) Indicates details about the error. Example: Unauthorized Example: Unauthorized - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Response | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. This is a unique identifier, a trace identifier, Flute attaches to a request/response pair so a single transaction can be traced end-to-end across systems and logs. Its intent is to support troubleshooting. We recommend including this value when contacting support. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. This is a field on Flute's standard error response object, alongside values such as `correlationId`, `errorCode`, or `statusCode`. It's the identifier of the specific resource the failed request was about. Error messages may specify "Entity with ID b31fbe9f-eebb-45ce-9cae-92265389f47f does not exist or has been deleted." When a 404 (or similar entity-specific error, like a conflict) comes back, check `entityId` to get the exact identifier of the record that couldn't be found or matched. This is useful for confirming which resource reference was wrong, especially if the request touched multiple identifiers at once. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) Indicates a short, human-readable summary of the error category. Example: Resource not found Example: Resource not found - `cause` (string) Indicates the reason the error occurred. Example: The requested resource does not exist or has been deleted. Example: The requested resource does not exist or has been deleted. - `resolution` (string) Indicates the recommended action for resolving the error. Example: Verify the resource ID is correct or retrieve a list of available resources. Example: Verify the resource ID is correct or retrieve a list of available resources. - `documentationUrl` (string) https://developer.flute.com/ ## Response 401: - `401` (unknown) Unauthorized ## Response 401 fields (application/json): - `details` (string) Indicates details about the error. Example: Unauthorized Example: Unauthorized - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Response | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. This is a unique identifier, a trace identifier, Flute attaches to a request/response pair so a single transaction can be traced end-to-end across systems and logs. Its intent is to support troubleshooting. We recommend including this value when contacting support. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. This is a field on Flute's standard error response object, alongside values such as `correlationId`, `errorCode`, or `statusCode`. It's the identifier of the specific resource the failed request was about. Error messages may specify "Entity with ID b31fbe9f-eebb-45ce-9cae-92265389f47f does not exist or has been deleted." When a 404 (or similar entity-specific error, like a conflict) comes back, check `entityId` to get the exact identifier of the record that couldn't be found or matched. This is useful for confirming which resource reference was wrong, especially if the request touched multiple identifiers at once. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) Indicates a short, human-readable summary of the error category. Example: Resource not found Example: Resource not found - `cause` (string) Indicates the reason the error occurred. Example: The requested resource does not exist or has been deleted. Example: The requested resource does not exist or has been deleted. - `resolution` (string) Indicates the recommended action for resolving the error. Example: Verify the resource ID is correct or retrieve a list of available resources. Example: Verify the resource ID is correct or retrieve a list of available resources. - `documentationUrl` (string) https://developer.flute.com/ ## Response 403: - `403` (unknown) Forbidden ## Response 403 fields (application/json): - `details` (string) Indicates details about the error. Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) - `cause` (string) - `resolution` (string) - `documentationUrl` (string) https://developer.flute.com/ - `errors` (object) ## Response 404: - `404` (unknown) Not Found ## Response 404 fields (application/json): - `details` (string) Indicates details about the error. Example: Unauthorized Example: Unauthorized - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Response | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. This is a unique identifier, a trace identifier, Flute attaches to a request/response pair so a single transaction can be traced end-to-end across systems and logs. Its intent is to support troubleshooting. We recommend including this value when contacting support. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. This is a field on Flute's standard error response object, alongside values such as `correlationId`, `errorCode`, or `statusCode`. It's the identifier of the specific resource the failed request was about. Error messages may specify "Entity with ID b31fbe9f-eebb-45ce-9cae-92265389f47f does not exist or has been deleted." When a 404 (or similar entity-specific error, like a conflict) comes back, check `entityId` to get the exact identifier of the record that couldn't be found or matched. This is useful for confirming which resource reference was wrong, especially if the request touched multiple identifiers at once. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) Indicates a short, human-readable summary of the error category. Example: Resource not found Example: Resource not found - `cause` (string) Indicates the reason the error occurred. Example: The requested resource does not exist or has been deleted. Example: The requested resource does not exist or has been deleted. - `resolution` (string) Indicates the recommended action for resolving the error. Example: Verify the resource ID is correct or retrieve a list of available resources. Example: Verify the resource ID is correct or retrieve a list of available resources. - `documentationUrl` (string) https://developer.flute.com/ ## Response 429: - `429` (unknown) Too Many Requests ## Response 429 fields (application/json): - `details` (string) Indicates details about the error. Example: Unauthorized Example: Unauthorized - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Response | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. This is a unique identifier, a trace identifier, Flute attaches to a request/response pair so a single transaction can be traced end-to-end across systems and logs. Its intent is to support troubleshooting. We recommend including this value when contacting support. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. This is a field on Flute's standard error response object, alongside values such as `correlationId`, `errorCode`, or `statusCode`. It's the identifier of the specific resource the failed request was about. Error messages may specify "Entity with ID b31fbe9f-eebb-45ce-9cae-92265389f47f does not exist or has been deleted." When a 404 (or similar entity-specific error, like a conflict) comes back, check `entityId` to get the exact identifier of the record that couldn't be found or matched. This is useful for confirming which resource reference was wrong, especially if the request touched multiple identifiers at once. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) Indicates a short, human-readable summary of the error category. Example: Resource not found Example: Resource not found - `cause` (string) Indicates the reason the error occurred. Example: The requested resource does not exist or has been deleted. Example: The requested resource does not exist or has been deleted. - `resolution` (string) Indicates the recommended action for resolving the error. Example: Verify the resource ID is correct or retrieve a list of available resources. Example: Verify the resource ID is correct or retrieve a list of available resources. - `documentationUrl` (string) https://developer.flute.com/ ## Response 500: - `500` (unknown) Internal Server Error ## Response 500 fields (application/json): - `details` (string) Indicates details about the error. Example: Unauthorized Example: Unauthorized - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Response | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. This is a unique identifier, a trace identifier, Flute attaches to a request/response pair so a single transaction can be traced end-to-end across systems and logs. Its intent is to support troubleshooting. We recommend including this value when contacting support. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. This is a field on Flute's standard error response object, alongside values such as `correlationId`, `errorCode`, or `statusCode`. It's the identifier of the specific resource the failed request was about. Error messages may specify "Entity with ID b31fbe9f-eebb-45ce-9cae-92265389f47f does not exist or has been deleted." When a 404 (or similar entity-specific error, like a conflict) comes back, check `entityId` to get the exact identifier of the record that couldn't be found or matched. This is useful for confirming which resource reference was wrong, especially if the request touched multiple identifiers at once. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) Indicates a short, human-readable summary of the error category. Example: Resource not found Example: Resource not found - `cause` (string) Indicates the reason the error occurred. Example: The requested resource does not exist or has been deleted. Example: The requested resource does not exist or has been deleted. - `resolution` (string) Indicates the recommended action for resolving the error. Example: Verify the resource ID is correct or retrieve a list of available resources. Example: Verify the resource ID is correct or retrieve a list of available resources. - `documentationUrl` (string) https://developer.flute.com/