Create Shareable Checkout Link

post

https://withpaper.com/api/2022-08-12/shareable-checkout-link

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

👍
Tip: Render your checkout link in a drawer
Open your new checkout in a drawer on your page in just one function call:
import { renderPaperCheckoutLink } from "@paperxyz/js-client-sdk"

const openCheckout = () => renderPaperCheckoutLink({
  checkoutLinkUrl: "https://withpaper.com/checkout/...",
});

<button onClick={openCheckout}>Buy with Paper</button>

Body Params

contractId

string

required

Defaults to f5b49e5b-2027-44c8-892c-911a17dffbea

The ID of your registered contract. This is not your contract's blockchain address.

title

string

required

Defaults to Mumbai Example

A clear title for this checkout that is shown on the checkout UX, credit card statement, and post-purchase email.

description

string

Defaults to Describe your project *with Markdown!*

A markdown-enabled description shown in the checkout.

imageUrl

string

Defaults to https://unsplash.it/240/240

An image to display on the checkout page. 240x240px images are preferred. Base64-encoded images, video files, and webpage links are not supported. Requirements: .webp (recommended), .png, .jpg, or .gif under 3 MB.

limitPerTransaction

int32

Defaults to 5

Limit the quantity a buyer can mint in a single purchase.

twitterHandleOverride

string

Override the Twitter handle shown in the checkout.

successCallbackUrl

string

The URL to navigate the buyer after completing their purchase. Set redirectAfterPayment: true to automatically redirect the buyer.

redirectAfterPayment

boolean

Defaults to false

If true, redirect the buyer to successCallbackUrl after payment, skipping the post-purchase page.

cancelCallbackUrl

string

The URL to navigate a buyer if the checkout link has expired, the NFT has sold out, the buyer is not eligible to purchase, etc.

mintMethod

json

Defaults to { "name": "claimTo", "args": { "_to": "$WALLET", "_quantity": "$QUANTITY", "_tokenId": 0 }, "payment": { "currency": "MATIC", "value": "0.001 * $QUANTITY" } }

Required for custom contracts. Remove this field if your contract type is not CUSTOM_CONTRACT. Details about your contract's method to purchase the NFT. See details.

eligibilityMethod

object

Optional, used only for custom contracts. Details about your smart contract's method to determine whether the buyer is eligible to purchase this NFT. See details.

tokenId

string

Required for ERC1155 thirdweb contracts. The token ID in the NFT collection to purchase.

listingId

string

Required for marketplace listings. The marketplace listing ID to purchase.

contractArgs

json

Required for thirdweb Edition Drop, thirdweb Signature Drop, and Solana Auction House contracts. Contract-specific details to complete this purchase. See details

hideNativeMint

boolean

Defaults to false

If true, disallow buyers from minting the NFT directly from the contract from their own wallet.

hidePaperWallet

boolean

Defaults to false

If true, disallow the buyer from sending the NFT to their Paper Wallet.

hideExternalWallet

boolean

Defaults to false

If true, disallow buyers from sending the NFT to their own wallets (MetaMask, WalletConnect, Coinbase Wallet).

hidePayWithCard

boolean

Defaults to false

If true, disallow buyers from paying with a credit card.

hidePayWithCrypto

boolean

Defaults to false

If true, disallow buyers from paying with ETH.

hidePayWithIdeal

boolean

Defaults to true

If true, disallow buyers from paying with iDEAL, a common payment method in the Netherlands. Learn more

sendEmailOnTransferSucceeded

boolean

Defaults to true

If true, Paper will email the buyer when their NFT is delivered. Tip: You can customize this email!

brandDarkMode

boolean

Defaults to false

If true, the checkout will use dark mode.

brandButtonShape

string

enum

Defaults to full

The shape of the buttons on the checkout screen.

Allowed:

brandColorScheme

string

enum

Defaults to blue

The color theme of the checkout.

Responses

Tip: Render your checkout link in a drawer

200200

400400