Skip to main content
The following Postman collection file is available for download. This collection includes example payloads and automatic JWT token generation for authenticated requests.

​
Prerequisites

Before using this collection, ensure you have:
  • Coinbase Business account
  • CDP API key using ECDSA signature algorithm
  • Downloaded the following files (we will use these to setup Postman):
Recommended: Use ECDSA keys for reliable testing with this Postman collection. While the Payment Link API itself supports both ECDSA and Ed25519 keys, ECDSA provides the most consistent experience in Postman.
The Payment Link APIs use the same authentication environment as other Coinbase Business APIs. You can reuse the Coinbase Developer Platform environment file.

​
1. Setup Postman

1

Access Postman

Use Postman Web to sign in (no installation needed).
Download from Postman Downloads if you prefer a native app
.
2

Import files

Once you are logged into Postman, you can import the files into your workspace through the web interface.Under “Get Started”, click on Import APIs and collections.
If you already have a Postman workspace, you can select Import in the upper-left corner of the screen.
Postman import screen showing Import APIs and collections option
Select both JSON files you downloaded and import them into your Postman workspace.

​
2. Configure your environment

Set up authentication by adding your CDP API key details to Postman.
1

Add your API credentials

In the left sidebar, click on Environments. Select the Coinbase Developer Platform Postman Environment option to see your environment variables.
Postman environment screen showing Coinbase Developer Platform Postman Environment in left sidebar
Add these two variables exactly as shown:
VariableValueWhere to find it
nameYour full API key name (with quotes)From the JSON file downloaded when creating your API key
privateKeyYour ECDSA private key (with quotes)From the JSON file downloaded when creating your API key
Example environment variable values:
name: "organizations/12345678-1234-5678-1234-567812345678/apiKeys/abcdef12-3456-7890-abcd-ef1234567890"

privateKey: "-----BEGIN EC PRIVATE KEY-----\nMHcCAQEEIJ8VsC2ifqfxDpq7mnVWdBKnqIRjFFg0zcC9U4RgKHQqoAoGCCqGSM49\nAwEHoUQDQgAEX7M5LCPd6rkeUxIK3/B9+2+3RQFvkEfMU4iN1ABm5VNUqNmRnJv4\nCxcdPIKreo4xuNr2S8Y5SU6IELb8HGc8Ow==\n-----END EC PRIVATE KEY-----\n"
Important:
  • Include the quotes as part of the value
  • Keep the privateKey on one line with \n for line breaks
  • Use an ECDSA key (starts with -----BEGIN EC PRIVATE KEY-----)

​
3. Authenticate and test endpoints

The Postman collection automatically generates a JWT token before each request using your environment variables.
1

Prep the collection

Navigate to the Collections tab in Postman and expand the “Coinbase Business Payment Links Collection” we added earlier.From the Environment dropdown in the upper-right corner, select the Coinbase Developer Platform Postman Environment we just configured.
Postman request screen showing Coinbase Developer Platform Postman Environment
2

Send your first request

Start with the List Payment Links request and click the Send button.You should receive a response similar to the following:
{
    "paymentLinks": []
}
3

Create a payment link

  1. Select the Create Payment Link request
  2. Review the pre-filled request body (you can modify amounts, description, etc.)
  3. Click Send
  4. Copy the url from the response - this is your payment link!

​
Available endpoints

The Payment Links collection includes the following endpoints:
  • Create Payment Link - Creates a new payment link for accepting cryptocurrency payments
  • List Payment Links - Retrieves a paginated list of payment links with optional filtering
  • Get Payment Link - Retrieves details of a specific payment link by ID
  • Deactivate Payment Link - Deactivates a payment link to prevent further payments

​
Troubleshooting

Confirm EnvironmentMake sure the correct environment is selected by checking the check mark to the right of the environment name in Postman.

​
Common issues and solutions

IssueSolution
Using Ed25519 key instead of ECDSAUse ECDSA key - starts with -----BEGIN EC PRIVATE KEY-----
Missing quotes in environment valuesInclude quotes around name and privateKey values
Invalid JSONCheck the environment dropdown is set to your CDP environment
401 Unauthorized errorsCheck JWT generation in Postman Console and verify credentials

​
Need additional help?

  • Documentation: Review the Authentication Guide
  • Community: Join the CDP Discord for support
  • Support: Contact Coinbase Business support with your X-Request-Id from failed requests