Home / Companies / Basis Theory / Blog / Post Details
Content Deep Dive

Decrypting Card Payload: Shopify Payments App

Blog post from Basis Theory

Post Details
Company
Date Published
Author
Davi Aquino
Word Count
760
Company Posts That Month
7
Language
English
Hacker News Points
-
Post removed?
No
Summary

A team supported an early Shopify Payments App adopter by integrating Shopify’s encrypted card-data workflow with the customer’s existing Node.js cardholder data environment. Shopify sends encrypted payment information through an mTLS-authenticated request, requiring the receiving system to validate Shopify’s self-signed certificates, return a prompt 200 OK response, and complete payment processing asynchronously. Using a programmable Basis Theory inbound proxy, the team designed a flow that decrypts Shopify’s ECIES-encrypted card data, tokenizes it, and forwards the original payload with a token replacing sensitive card information to the customer’s payment app, allowing it to use its preferred downstream acquirer. Because Shopify’s documentation initially provided only Ruby examples and no suitable Node.js package existed, the developer implemented the required ECIES hybrid decryption process in Node.js using ECDH shared-secret generation, key derivation, MAC validation, and payload decryption. After validating the proof of concept, adding key rotation, and refining the code, the team released an open-source Shopify JavaScript package for customers and the wider Node.js community.

Trends Found in this Post

No tracked trend matches for this post yet.

Use This Data

Use this post, company, and trend context to find content marketing opportunities, perform competitive analysis, or address product feature gaps via the Plushcap MCP server or the Plushcap API.