Retrieve a payment link

Retrieves the details of an existing payment link. Supply the unique payment link ID from either a payment link creation request or the payment link list, and PriceBlocs will return the corresponding payment link information.
Parameters
Has no parameters
Returns
  • Returns a payment link object if a valid identifier was provided.
Have any questions or feedback?
GET
/v1/payment-links/:id
1
curl https://api.priceblocs.com/v1/payment-links/{{PAYMENT_LINK_ID}} \
2
-H "Authorization: Bearer {{API_KEY_SECRET_TEST}}"
Response
1
{
2
"url": "https://priceblocs.com/test/links/short_id",
3
"brand_url": "https://priceblocs.com/test/links/short_id",
4
"livemode": false,
5
"id": "00000000-0000-0000-0000-000000000000",
6
"object": "payment_link",
7
"short_id": "short_id",
8
"title": "My first payment link",
9
"description": "Each link will start a new checkout session when clicked",
10
"success_url": "https://priceblocs.com/checkout/success",
11
"cancel_url": "https://priceblocs.com/checkout/error",
12
"created": 1628234366,
13
"updated": 1628234366,
14
"payment_method_types": [
15
"card"
16
],
17
"currency": "usd",
18
"customer_email": "someone@gmail.com",
19
"customer": null,
20
"status": "active",
21
"discounts": [
22
{
23
"coupon": "coupon123"
24
}
25
],
26
"billing_address_collection": "auto",
27
"shipping_address_collection": {
28
"allowed_countries": [
29
"US"
30
]
31
},
32
"mode": "subscription",
33
"submit_type": "pay",
34
"allow_promotion_codes": false,
35
"adjustable_quantity": {
36
"enabled": true,
37
"maximum": 99,
38
"minimum": 1
39
},
40
"shipping_worldwide": false,
41
"tax_rates": [
42
"txr_123"
43
],
44
"dynamic_tax_rates": [
45
"txr_456"
46
],
47
"automatic_tax": {
48
"enabled": true
49
},
50
"tax_id_collection": {
51
"enabled": false,
52
"type": "standard"
53
},
54
"consent_collection": {
55
"promotions": "auto"
56
},
57
"after_expiration": {
58
"recovery": {
59
"enabled": true,
60
"allow_promotion_codes": true
61
}
62
},
63
"expires_at": 1628234366,
64
"shipping_options": [
65
{
66
"shipping_rate": "shr_456"
67
}
68
],
69
"payment_intent_data": {
70
"capture_method": "automatic",
71
"transfer_data": {
72
"destination": "act_123"
73
}
74
},
75
"trial_period_days": null,
76
"trial_end": null,
77
"line_items": [
78
{
79
"price": "p_A_1",
80
"product": "p_A",
81
"currency": "usd",
82
"interval": "month",
83
"quantity": 1,
84
"dynamic_tax_rates": null,
85
"tax_rates": null
86
}
87
]
88
}
Show docs menu

Retrieve a payment link

Retrieves the details of an existing payment link. Supply the unique payment link ID from either a payment link creation request or the payment link list, and PriceBlocs will return the corresponding payment link information.
Parameters
Has no parameters
Returns
  • Returns a payment link object if a valid identifier was provided.
Have any questions or feedback?
GET
/v1/payment-links/:id
1
curl https://api.priceblocs.com/v1/payment-links/{{PAYMENT_LINK_ID}} \
2
-H "Authorization: Bearer {{API_KEY_SECRET_TEST}}"
Response
1
{
2
"url": "https://priceblocs.com/test/links/short_id",
3
"brand_url": "https://priceblocs.com/test/links/short_id",
4
"livemode": false,
5
"id": "00000000-0000-0000-0000-000000000000",
6
"object": "payment_link",
7
"short_id": "short_id",
8
"title": "My first payment link",
9
"description": "Each link will start a new checkout session when clicked",
10
"success_url": "https://priceblocs.com/checkout/success",
11
"cancel_url": "https://priceblocs.com/checkout/error",
12
"created": 1628234366,
13
"updated": 1628234366,
14
"payment_method_types": [
15
"card"
16
],
17
"currency": "usd",
18
"customer_email": "someone@gmail.com",
19
"customer": null,
20
"status": "active",
21
"discounts": [
22
{
23
"coupon": "coupon123"
24
}
25
],
26
"billing_address_collection": "auto",
27
"shipping_address_collection": {
28
"allowed_countries": [
29
"US"
30
]
31
},
32
"mode": "subscription",
33
"submit_type": "pay",
34
"allow_promotion_codes": false,
35
"adjustable_quantity": {
36
"enabled": true,
37
"maximum": 99,
38
"minimum": 1
39
},
40
"shipping_worldwide": false,
41
"tax_rates": [
42
"txr_123"
43
],
44
"dynamic_tax_rates": [
45
"txr_456"
46
],
47
"automatic_tax": {
48
"enabled": true
49
},
50
"tax_id_collection": {
51
"enabled": false,
52
"type": "standard"
53
},
54
"consent_collection": {
55
"promotions": "auto"
56
},
57
"after_expiration": {
58
"recovery": {
59
"enabled": true,
60
"allow_promotion_codes": true
61
}
62
},
63
"expires_at": 1628234366,
64
"shipping_options": [
65
{
66
"shipping_rate": "shr_456"
67
}
68
],
69
"payment_intent_data": {
70
"capture_method": "automatic",
71
"transfer_data": {
72
"destination": "act_123"
73
}
74
},
75
"trial_period_days": null,
76
"trial_end": null,
77
"line_items": [
78
{
79
"price": "p_A_1",
80
"product": "p_A",
81
"currency": "usd",
82
"interval": "month",
83
"quantity": 1,
84
"dynamic_tax_rates": null,
85
"tax_rates": null
86
}
87
]
88
}