BeatPass Documentation - Help Center & Developer Docs

Initiate a track purchase via Stripe

curl --request POST \
  --url https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "client_secret": "<string>",
  "purchase_id": 123
}

{
  "status": "error",
  "message": "Reason for the error",
  "errors": {
    "some_data_1": "Error message for data 1",
    "some_data_2": "Error message for data 2"
  }
}

POST

tracks

{id}

purchase

initiate

Initiate a track purchase via Stripe

curl --request POST \
  --url https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://open.beatpass.ca/api/v1/tracks/{id}/purchase/initiate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "client_secret": "<string>",
  "purchase_id": 123
}

{
  "status": "error",
  "message": "Reason for the error",
  "errors": {
    "some_data_1": "Error message for data 1",
    "some_data_2": "Error message for data 2"
  }
}

Authorizations

Authorization

string

header

required

API access is invite-only. Contact contact@beatpass.ca to request access. Once approved, generate tokens from Account Settings → Developers. Include as: Authorization: Bearer {token}. Tokens expire after 90 days.

Path Parameters

integer

required

Track ID

Example:

1

Response

Stripe PaymentIntent created

client_secret

string

Stripe PaymentIntent client secret

purchase_id

integer

Last modified on July 31, 2026

Calculate track purchase price Check purchase status for a track

Introduction

Core Concepts

API Reference

Search

Playlists

Artists

Albums

Tracks

Tags

Genres

Users

Auth

License Certificates

Audio Fingerprinting

Playlist Collaboration

Reposts

Track Plays

Radio

Cover Art

Track Purchases

Beat Requests

Producer Intelligence

User Library

Leaderboards

Messaging

Collections

Stripe Connect

Exclusive Licenses

Coupons

Notifications

Initiate a track purchase via Stripe

Authorizations

Path Parameters

Response