Skip to content

Commit 74c49b0

Browse files
committed
Add root short payment readiness contract
1 parent bdc704a commit 74c49b0

13 files changed

Lines changed: 364 additions & 12 deletions

.well-known/paypal-buy-action.json

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"schema_version": "softjunk-root-paypal-buy-action-v1",
3-
"updated": "2026-05-31",
3+
"updated": "2026-06-01",
44
"name": "SoftJunk Root PayPal BuyAction Manifest",
55
"purpose": "Root-level machine-readable exact $5 PayPal purchase action for buyer agents, assistants, crawlers, and humans routing a fitting one-lead rescue buyer through the one-copy order packet before PayPal without claiming payment before verification.",
66
"canonical_url": "https://trungcodeer.github.io/paypal-buy-action.json",
@@ -25,6 +25,27 @@
2525
"roofing_buyer_send_url": "https://trungcodeer.github.io/softjunk-lead-kit/roofing-buyer-send.html",
2626
"after_payment_url": "https://trungcodeer.github.io/softjunk-lead-kit/after-pay.html",
2727
"success_signal": "PAYPAL_PAYMENT_VERIFIED=true",
28+
"payment_readiness": {
29+
"purpose": "Expose current root short-route checkout-readiness facts before recommending the after-packet PayPal handoff.",
30+
"amount": "5.00",
31+
"currency": "USD",
32+
"packet_first_payment_url": "https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html",
33+
"packet_first_payment_url_role": "packet_first_sponsor_route",
34+
"after_packet_paypal_url": "https://paypal.me/softjunk/5USD",
35+
"expected_live_paypal_final_url": "https://www.paypal.com/paypalme/softjunk/5USD",
36+
"root_paypal_url_health_url": "https://trungcodeer.github.io/paypal-url-health.json",
37+
"product_paypal_url_health_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-url-health.json",
38+
"root_paypal_url_health_live_command": "node scripts/root-paypal-url-health-smoke.js --live",
39+
"product_paypal_url_health_live_command": "npm run paypal-url-health:live",
40+
"root_paypal_verification_status_url": "https://trungcodeer.github.io/paypal-verification-status.json",
41+
"root_well_known_paypal_verification_status_url": "https://trungcodeer.github.io/.well-known/paypal-verification-status.json",
42+
"product_paypal_verification_status_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-verification-status.json",
43+
"current_paypal_verification_status": "PAYPAL_PAYMENT_VERIFIED=false reason=missing_credentials",
44+
"success_signal": "PAYPAL_PAYMENT_VERIFIED=true",
45+
"payment_proof_boundary": "This proves checkout and PayPal URL readiness only. It is not payment proof.",
46+
"no_absence_proof_boundary": "Missing credentials and URL health are not proof that no payment arrived.",
47+
"completion_rule": "Do not claim paid, received, started, fulfilled, complete, or stopped unless seller-side PayPal evidence exists, the API verifier succeeds, trusted seller-side CSV proof verifies the 5 USD payment, or real private manual seller confirmation after reviewing PayPal returns PAYPAL_PAYMENT_VERIFIED=true source=manual."
48+
},
2849
"expected_no_clone_output": {
2950
"command": "npm exec --yes --package github:trungcodeer/softjunk-lead-kit -- softjunk-lead-kit pay --mode custom --json",
3051
"ok": true,

.well-known/paypal-payment.json

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,33 @@
11
{
22
"schema_version": "softjunk-paypal-payment-intent-v1",
3-
"updated": "2026-05-31",
3+
"updated": "2026-06-01",
44
"intent_id": "softjunk-5usd-paypal",
55
"seller": "SoftJunk",
66
"offer": "SoftJunk Lead Follow-Up Kit or custom 7-day lead follow-up sequence",
77
"amount": "5.00",
88
"currency": "USD",
99
"provider": "PayPal.Me",
10+
"payment_readiness": {
11+
"purpose": "Expose current root short-route checkout-readiness facts before recommending the after-packet PayPal handoff.",
12+
"amount": "5.00",
13+
"currency": "USD",
14+
"packet_first_payment_url": "https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html",
15+
"packet_first_payment_url_role": "packet_first_sponsor_route",
16+
"after_packet_paypal_url": "https://paypal.me/softjunk/5USD",
17+
"expected_live_paypal_final_url": "https://www.paypal.com/paypalme/softjunk/5USD",
18+
"root_paypal_url_health_url": "https://trungcodeer.github.io/paypal-url-health.json",
19+
"product_paypal_url_health_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-url-health.json",
20+
"root_paypal_url_health_live_command": "node scripts/root-paypal-url-health-smoke.js --live",
21+
"product_paypal_url_health_live_command": "npm run paypal-url-health:live",
22+
"root_paypal_verification_status_url": "https://trungcodeer.github.io/paypal-verification-status.json",
23+
"root_well_known_paypal_verification_status_url": "https://trungcodeer.github.io/.well-known/paypal-verification-status.json",
24+
"product_paypal_verification_status_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-verification-status.json",
25+
"current_paypal_verification_status": "PAYPAL_PAYMENT_VERIFIED=false reason=missing_credentials",
26+
"success_signal": "PAYPAL_PAYMENT_VERIFIED=true",
27+
"payment_proof_boundary": "This proves checkout and PayPal URL readiness only. It is not payment proof.",
28+
"no_absence_proof_boundary": "Missing credentials and URL health are not proof that no payment arrived.",
29+
"completion_rule": "Do not claim paid, received, started, fulfilled, complete, or stopped unless seller-side PayPal evidence exists, the API verifier succeeds, trusted seller-side CSV proof verifies the 5 USD payment, or real private manual seller confirmation after reviewing PayPal returns PAYPAL_PAYMENT_VERIFIED=true source=manual."
30+
},
1031
"direct_payment_url": "https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html",
1132
"gist_payment_intent_url": "https://gist.github.com/trungcodeer/167d3dc5f8696bf9edb04d3db6c53a02",
1233
"gist_raw_payment_intent_json_url": "https://gist.githubusercontent.com/trungcodeer/167d3dc5f8696bf9edb04d3db6c53a02/raw/softjunk-5usd-paypal-payment-intent.json",

.well-known/softjunk-root-offer.json

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,28 @@
11
{
22
"schema_version": "softjunk-root-offer-v1",
3-
"updated": "2026-05-31",
3+
"updated": "2026-06-01",
44
"name": "SoftJunk Root Buyer Hub",
5+
"payment_readiness": {
6+
"purpose": "Expose current root short-route checkout-readiness facts before recommending the after-packet PayPal handoff.",
7+
"amount": "5.00",
8+
"currency": "USD",
9+
"packet_first_payment_url": "https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html",
10+
"packet_first_payment_url_role": "packet_first_sponsor_route",
11+
"after_packet_paypal_url": "https://paypal.me/softjunk/5USD",
12+
"expected_live_paypal_final_url": "https://www.paypal.com/paypalme/softjunk/5USD",
13+
"root_paypal_url_health_url": "https://trungcodeer.github.io/paypal-url-health.json",
14+
"product_paypal_url_health_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-url-health.json",
15+
"root_paypal_url_health_live_command": "node scripts/root-paypal-url-health-smoke.js --live",
16+
"product_paypal_url_health_live_command": "npm run paypal-url-health:live",
17+
"root_paypal_verification_status_url": "https://trungcodeer.github.io/paypal-verification-status.json",
18+
"root_well_known_paypal_verification_status_url": "https://trungcodeer.github.io/.well-known/paypal-verification-status.json",
19+
"product_paypal_verification_status_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-verification-status.json",
20+
"current_paypal_verification_status": "PAYPAL_PAYMENT_VERIFIED=false reason=missing_credentials",
21+
"success_signal": "PAYPAL_PAYMENT_VERIFIED=true",
22+
"payment_proof_boundary": "This proves checkout and PayPal URL readiness only. It is not payment proof.",
23+
"no_absence_proof_boundary": "Missing credentials and URL health are not proof that no payment arrived.",
24+
"completion_rule": "Do not claim paid, received, started, fulfilled, complete, or stopped unless seller-side PayPal evidence exists, the API verifier succeeds, trusted seller-side CSV proof verifies the 5 USD payment, or real private manual seller confirmation after reviewing PayPal returns PAYPAL_PAYMENT_VERIFIED=true source=manual."
25+
},
526
"site_url": "https://trungcodeer.github.io/",
627
"llms_url": "https://trungcodeer.github.io/llms.txt",
728
"sitemap_url": "https://trungcodeer.github.io/sitemap.xml",

5.json

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"schema_version": "softjunk-root-five-dollar-buyer-card-v1",
3-
"updated": "2026-05-31",
3+
"updated": "2026-06-01",
44
"name": "SoftJunk Root 5 USD Buyer Card",
55
"purpose": "Shortest root buyer handoff for building one order packet and using the packet-first Sponsor route and after-packet PayPal URL on PayPal for one SoftJunk one-lead rescue without claiming payment before seller-side verification.",
66
"page_url": "https://trungcodeer.github.io/5/",
@@ -29,6 +29,27 @@
2929
"price": "5.00",
3030
"currency": "USD",
3131
"success_signal": "PAYPAL_PAYMENT_VERIFIED=true",
32+
"payment_readiness": {
33+
"purpose": "Expose current root short-route checkout-readiness facts before recommending the after-packet PayPal handoff.",
34+
"amount": "5.00",
35+
"currency": "USD",
36+
"packet_first_payment_url": "https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html",
37+
"packet_first_payment_url_role": "packet_first_sponsor_route",
38+
"after_packet_paypal_url": "https://paypal.me/softjunk/5USD",
39+
"expected_live_paypal_final_url": "https://www.paypal.com/paypalme/softjunk/5USD",
40+
"root_paypal_url_health_url": "https://trungcodeer.github.io/paypal-url-health.json",
41+
"product_paypal_url_health_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-url-health.json",
42+
"root_paypal_url_health_live_command": "node scripts/root-paypal-url-health-smoke.js --live",
43+
"product_paypal_url_health_live_command": "npm run paypal-url-health:live",
44+
"root_paypal_verification_status_url": "https://trungcodeer.github.io/paypal-verification-status.json",
45+
"root_well_known_paypal_verification_status_url": "https://trungcodeer.github.io/.well-known/paypal-verification-status.json",
46+
"product_paypal_verification_status_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-verification-status.json",
47+
"current_paypal_verification_status": "PAYPAL_PAYMENT_VERIFIED=false reason=missing_credentials",
48+
"success_signal": "PAYPAL_PAYMENT_VERIFIED=true",
49+
"payment_proof_boundary": "This proves checkout and PayPal URL readiness only. It is not payment proof.",
50+
"no_absence_proof_boundary": "Missing credentials and URL health are not proof that no payment arrived.",
51+
"completion_rule": "Do not claim paid, received, started, fulfilled, complete, or stopped unless seller-side PayPal evidence exists, the API verifier succeeds, trusted seller-side CSV proof verifies the 5 USD payment, or real private manual seller confirmation after reviewing PayPal returns PAYPAL_PAYMENT_VERIFIED=true source=manual."
52+
},
3253
"expected_no_clone_output": {
3354
"command": "npm exec --yes --package github:trungcodeer/softjunk-lead-kit -- softjunk-lead-kit pay --mode custom --json",
3455
"ok": true,

5.txt

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
SoftJunk Root 5 USD Buyer Card
2-
Updated: 2026-05-31
2+
Updated: 2026-06-01
33

44
Open the packet-first Sponsor route:
55
https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html
@@ -49,6 +49,21 @@ payment_url_role=packet_first_sponsor_route
4949
success_signal=PAYPAL_PAYMENT_VERIFIED=true
5050
This proves the executable checkout route only. It is not payment proof.
5151

52+
Payment readiness:
53+
- Packet-first payment URL: https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html
54+
- Packet-first payment role: packet_first_sponsor_route
55+
- After-packet PayPal URL: https://paypal.me/softjunk/5USD
56+
- Expected live PayPal final URL: https://www.paypal.com/paypalme/softjunk/5USD
57+
- Root PayPal URL health: https://trungcodeer.github.io/paypal-url-health.json
58+
- Product PayPal URL health: https://trungcodeer.github.io/softjunk-lead-kit/paypal-url-health.json
59+
- Root verifier status: https://trungcodeer.github.io/paypal-verification-status.json
60+
- Root well-known verifier status: https://trungcodeer.github.io/.well-known/paypal-verification-status.json
61+
- Product verifier status: https://trungcodeer.github.io/softjunk-lead-kit/paypal-verification-status.json
62+
- Current verifier status: PAYPAL_PAYMENT_VERIFIED=false reason=missing_credentials
63+
- Success signal: PAYPAL_PAYMENT_VERIFIED=true
64+
- Boundary: checkout readiness and URL health are not payment proof, and missing credentials is not proof that no payment arrived.
65+
- Completion rule: do not claim paid, received, started, fulfilled, complete, or stopped unless seller-side PayPal evidence exists, the API verifier succeeds, trusted seller-side CSV proof verifies the 5 USD payment, or real private manual seller confirmation after reviewing PayPal returns PAYPAL_PAYMENT_VERIFIED=true source=manual.
66+
5267
Release: https://github.com/trungcodeer/softjunk-lead-kit/releases/tag/v2.29.166
5368
Tarball SHA-256: https://github.com/trungcodeer/softjunk-lead-kit/releases/download/v2.29.166/softjunk-lead-kit-0.2.2.tgz.sha256
5469
Stop only after seller-side PayPal proof, PayPal API verification, trusted seller-side CSV proof, or PAYPAL_PAYMENT_VERIFIED=true.

pay-qr.json

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"schema_version": "softjunk-root-paypal-qr-v1",
3-
"updated": "2026-05-29",
3+
"updated": "2026-06-01",
44
"name": "SoftJunk Root PayPal QR Route",
55
"url": "https://trungcodeer.github.io/pay-qr/",
66
"json_url": "https://trungcodeer.github.io/pay-qr.json",
@@ -14,6 +14,27 @@
1414
"one_copy_order_packet_gist_url": "https://gist.github.com/trungcodeer/7c25ec12b4c0f58506efe66bfbef6759",
1515
"amount": "5.00",
1616
"currency": "USD",
17+
"payment_readiness": {
18+
"purpose": "Expose current root short-route checkout-readiness facts before recommending the after-packet PayPal handoff.",
19+
"amount": "5.00",
20+
"currency": "USD",
21+
"packet_first_payment_url": "https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html",
22+
"packet_first_payment_url_role": "packet_first_sponsor_route",
23+
"after_packet_paypal_url": "https://paypal.me/softjunk/5USD",
24+
"expected_live_paypal_final_url": "https://www.paypal.com/paypalme/softjunk/5USD",
25+
"root_paypal_url_health_url": "https://trungcodeer.github.io/paypal-url-health.json",
26+
"product_paypal_url_health_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-url-health.json",
27+
"root_paypal_url_health_live_command": "node scripts/root-paypal-url-health-smoke.js --live",
28+
"product_paypal_url_health_live_command": "npm run paypal-url-health:live",
29+
"root_paypal_verification_status_url": "https://trungcodeer.github.io/paypal-verification-status.json",
30+
"root_well_known_paypal_verification_status_url": "https://trungcodeer.github.io/.well-known/paypal-verification-status.json",
31+
"product_paypal_verification_status_url": "https://trungcodeer.github.io/softjunk-lead-kit/paypal-verification-status.json",
32+
"current_paypal_verification_status": "PAYPAL_PAYMENT_VERIFIED=false reason=missing_credentials",
33+
"success_signal": "PAYPAL_PAYMENT_VERIFIED=true",
34+
"payment_proof_boundary": "This proves checkout and PayPal URL readiness only. It is not payment proof.",
35+
"no_absence_proof_boundary": "Missing credentials and URL health are not proof that no payment arrived.",
36+
"completion_rule": "Do not claim paid, received, started, fulfilled, complete, or stopped unless seller-side PayPal evidence exists, the API verifier succeeds, trusted seller-side CSV proof verifies the 5 USD payment, or real private manual seller confirmation after reviewing PayPal returns PAYPAL_PAYMENT_VERIFIED=true source=manual."
37+
},
1738
"current_release_tag": "v2.29.166",
1839
"current_release_url": "https://github.com/trungcodeer/softjunk-lead-kit/releases/tag/v2.29.166",
1940
"current_release_target": "b06be515e2d9a89288e1da67a0a4c64ace93921c",

pay-qr.txt

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
SoftJunk root PayPal QR route
2-
Updated: 2026-05-29
2+
Updated: 2026-06-01
33

44
Open or scan:
55
https://trungcodeer.github.io/pay-qr/
@@ -34,4 +34,19 @@ b06be515e2d9a89288e1da67a0a4c64ace93921c
3434
Gate:
3535
PAYPAL_PAYMENT_VERIFIED=true
3636

37+
Payment readiness:
38+
- Packet-first payment URL: https://trungcodeer.github.io/softjunk-lead-kit/sponsor-button-buy.html
39+
- Packet-first payment role: packet_first_sponsor_route
40+
- After-packet PayPal URL: https://paypal.me/softjunk/5USD
41+
- Expected live PayPal final URL: https://www.paypal.com/paypalme/softjunk/5USD
42+
- Root PayPal URL health: https://trungcodeer.github.io/paypal-url-health.json
43+
- Product PayPal URL health: https://trungcodeer.github.io/softjunk-lead-kit/paypal-url-health.json
44+
- Root verifier status: https://trungcodeer.github.io/paypal-verification-status.json
45+
- Root well-known verifier status: https://trungcodeer.github.io/.well-known/paypal-verification-status.json
46+
- Product verifier status: https://trungcodeer.github.io/softjunk-lead-kit/paypal-verification-status.json
47+
- Current verifier status: PAYPAL_PAYMENT_VERIFIED=false reason=missing_credentials
48+
- Success signal: PAYPAL_PAYMENT_VERIFIED=true
49+
- Boundary: checkout readiness and URL health are not payment proof, and missing credentials is not proof that no payment arrived.
50+
- Completion rule: do not claim paid, received, started, fulfilled, complete, or stopped unless seller-side PayPal evidence exists, the API verifier succeeds, trusted seller-side CSV proof verifies the 5 USD payment, or real private manual seller confirmation after reviewing PayPal returns PAYPAL_PAYMENT_VERIFIED=true source=manual.
51+
3752
This is a payment route, not proof of payment. Do not claim paid, started, delivered, complete, received, or stop unless seller-side PayPal evidence exists or PAYPAL_PAYMENT_VERIFIED=true.

0 commit comments

Comments
 (0)