{"id":29020265,"url":"https://github.com/webdna/commerce-braintree","last_synced_at":"2025-06-26T01:05:02.816Z","repository":{"id":43291883,"uuid":"158377964","full_name":"webdna/commerce-braintree","owner":"webdna","description":"Braintree gateway for Craft Commerce","archived":false,"fork":false,"pushed_at":"2025-06-05T11:00:10.000Z","size":161,"stargazers_count":2,"open_issues_count":9,"forks_count":12,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-05T11:44:16.889Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webdna.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-20T11:20:46.000Z","updated_at":"2025-06-05T10:45:33.000Z","dependencies_parsed_at":"2024-02-06T10:29:46.621Z","dependency_job_id":"93fa2db5-89a2-46b3-a81c-a4e6f3e6640b","html_url":"https://github.com/webdna/commerce-braintree","commit_stats":{"total_commits":109,"total_committers":10,"mean_commits":10.9,"dds":0.4954128440366973,"last_synced_commit":"8e19852d0744b9cdc52234daf886f68704ce5ab2"},"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/webdna/commerce-braintree","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdna%2Fcommerce-braintree","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdna%2Fcommerce-braintree/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdna%2Fcommerce-braintree/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdna%2Fcommerce-braintree/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webdna","download_url":"https://codeload.github.com/webdna/commerce-braintree/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdna%2Fcommerce-braintree/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261978912,"owners_count":23239417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-26T01:04:58.302Z","updated_at":"2025-06-26T01:05:02.746Z","avatar_url":"https://github.com/webdna.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"./src/icon.svg\" width=\"100\" height=\"100\" alt=\"Braintree for Craft Commerce icon\"\u003e\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eBraintree for Craft Commerce\u003c/h1\u003e\n\nThis plugin provides a [Braintree](https://www.braintreegateway.com) integration for [Craft Commerce](https://craftcms.com/commerce).\n\n## Features\n\n-   Merchant Accounts: supports Braintree's merchant accounts for multiple payment currencies.\n-   Subscriptions: support subscription integration.\n-   DropinUi: Braintree's dropinUi is the default for `getPaymentFromHTML()` method.\n-   Supports 3DSecure 2.\n-   Supports Paypal, Apple Pay \u0026 Google Pay.\n-   Vault: Supports Braintree's vault for securely storing payment details.\n\n## Requirements\n\nThis plugin requires Craft Commerce 4.0 or later.\n\n## Installation\n\nYou can install this plugin from the Plugin Store or with Composer.\n\n#### From the Plugin Store\n\nGo to the Plugin Store in your project’s Control Panel and search for Braintree for Craft Commerce”. Then click on the “Install” button in its modal window.\n\n#### With Composer\n\nOpen your terminal and run the following commands:\n\n```bash\n# go to the project directory\ncd /path/to/my-project.test\n\n# tell Composer to load the plugin\ncomposer require webdna/commerce-braintree\n\n# tell Craft to install the plugin\n./craft plugin/install commerce-braintree\n```\n\n## Setup\n\nTo add the Braintree payment gateway, go to Commerce → Settings → Gateways, create a new gateway, and set the gateway type to “Braintree”.\n\n## Payment security enforcement\n\nThis plugin does not allow submitting credit card details directly to Braintree gateway. Instead, you must tokenize the card before submitting the payment form. Calling the default `getPaymentFormHtml()` method on the gateway will automatically use Braintree's DropinUI interface and tokenize the payment details. If you wish to have control over the dropinUi options or would prefer to use Braintree's HostedFields instead, you will need to manually add the fields and javascript instead of using the default method.\n\n## 3D secure payments\n\nTo allow 3D Secure payments, you must enable it in your Braintree account, then pass in the optional parameter into the `getPaymentFormHtml()` method. Default: false\n\n```\ngateway.getPaymentFormHtml({threeDSecure:true})\n```\n\n## Options\n\nThese are options that can be passed into the default `getPaymentFormHtml()` method.\n\n### Store Name\n\nThis will set the store name for paypal, google pay \u0026 apple pay. Default: siteName\n\n```\ngateway.getPaymentFormHtml({storeName:'My WebSite'})\n```\n\n### Translations\n\nThis will allow the setting of the dropinUi translations: [Examples](https://github.com/braintree/braintree-web-drop-in/blob/master/src/translations/en_US.js)\n\n```\ngateway.getPaymentFormHtml({translations:{chooseAWayToPay:'Choose a way to pay'}})\n```\n\n### Vault\n\nThis allows the payment details to be store in Braintree's Vault, not the website. The DropinUi will display all saved payment methods. Default: false\n\n```\ngateway.getPaymentFormHtml({vault:true})\n```\n\nIf you would like to allow the management of vaulted payment methods, then pass in the `manage` option. Default: false\n\n```\ngateway.getPaymentFormHtml({manage:true})\n```\n\n## Subscriptions\n\n### Creating a subscription plan\n\n1. To create a subscription plan, it must first be created within your Braintree account.\n2. Go to Commerce → Settings → Subscription plans and create a new subscription plan.\n\n### Options when subscribing\n\n#### Trial Days\n\nTrial days are setup as part of the plan within Braintree.\n\n### Options when switching between different subscription plans\n\n#### The `prorate` parameter\n\nIf this parameter is set to true, the subscription switch will be prorated.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdna%2Fcommerce-braintree","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebdna%2Fcommerce-braintree","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdna%2Fcommerce-braintree/lists"}