Create Payment Link

Creates a new payment request that generates a payment URL and optionally a QR code.

1. Choose the environment

You must invoke a POST request to the following URLs according to your needs:

Stage: https://h2h.stage.bamboopayment.com/api/v1/payments

Production: https://h2h.bamboopayment.com/api/v1/payments

2. Building the Request

Parameter	Type	Required?	Description
`amount`	`integer`	Yes	Payment amount in the smallest currency unit (e.g., 123450 represents 1,234.50)
`currencyCode`	`string`	Yes	Currency code in ISO 4217 alpha-3 format (e.g., `UYU`, `USD`)
`paymentType`	`string`	Yes	Type of payment. Must be "QR" to enable QR code generation or "CheckoutPro" only for Payment Link. When set to "QR", the `qrImageOptions` object becomes optional. For any other payment type, `qrImageOptions` must be null
`orderNumber`	`string`	No	Merchant's order identifier
`installments`	`integer[]`	No	List of installments. If not provided, takes default for each payment method configured in Merchant Portal. If not configured in Merchant Dashboard, takes `1`
`validForMinutes`	`integer`	No	Payment link validity time, after which it cannot be processed. Default: `15` minutes. Can only be reduced, not increased
`notificationUrl`	`string`	No	URL to notify the payment status. A default can be configured in Merchant Dashboard.
`metadataIn`	`object`	No	Additional data specific to each country and acquirer

MetadataIn Object

Parameter	Type	Required?	Description
`metadataIn` → `invoiceNumber`	`string`	No	Invoice number associated with the sale
`metadataIn` → `isFinalConsumer`	`string`	No	Indicates if the sale is to a final consumer. Values: `true`, `false`
`metadataIn` → `taxableAmount`	`string`	No	VAT taxable amount

QRImageOptions Object

Parameter	Type	Required?	Description
`qrImageOptions` → `contentType`	`string`	No	Defines how the QR code content will be structured: `encodedJson`: Encodes payment data as Base64 JSON. This prevents QR scanners from automatically opening URLs. `url`: Embeds the RedirectUrl directly in the QR code for easy scanning and immediate redirection. Default: `encodedJson`
`qrImageOptions` → `encodedJsonPrefix`	`string`	No	Prepends the Base64 encoded payment information with this prefix. Useful for custom URL schemes in mobile apps.
`qrImageOptions` → `errorCorrectionLevel`	`string`	No	Sets the QR code's error correction capability: `low`: 7% error tolerance `medium`: 15% error tolerance `quartile`: 25% error tolerance `high`: 30% error tolerance Default: `quartile`
`qrImageOptions` → `imageFormat`	`string`	No	Specifies the pixel format of the image: `rgb24`: 8-bit RGB color (3 channels) `argb32`: 8-bit ARGB color with alpha channel (4 channels) Default: `rgb24`
`qrImageOptions` → `imagePixelFormat`	`string`	No	Specifies the image format: PNG, BMP, GIF, JPEG, PBM, TGA, TIFF, WEBP. Default: `png`
`qrImageOptions` → `scale`	`integer`	No	Width and height, in pixels, of each module of the QR code. Default: `10`
`qrImageOptions` → `border`	`integer`	No	Number of border modules added to each side of the QR code image. Default: `2`
`qrImageOptions` → `foregroundColor`	`string`	No	QR code color. Accepts color names or hex values. Default: "black"
`qrImageOptions` → `backgroundColor`	`string`	No	Background color. Accepts color names or hex values. Default: "white"
`qrImageOptions` → `borderColor`	`string`	No	Border color. Accepts color names or hex values. Default: Same as backgroundColor.
`qrImageOptions` → `embeddedImageName`	`string`	No	Name of a pre-loaded image in the Merchant Portal to display in the center of the QR code.
`qrImageOptions` → `embeddedImageRelativeWidth`	`float`	No	Size of the embedded image relative to the QR code width. Example: 0.25 means the image will occupy 25% of the QR code width. If not specified, the image retains its original size.

Important: This object is optional when paymentType is "QR" and must be null for any other payment type.