Here you will find a sample web application that demonstrates some of the features of the Circle Payments API.
For full details on what you can do with Circle's APIs and how to use them, please check the API documentation portal.
You can manually clone the sample app by running:
$ git clone https://github.com/circlefin/payments-sample-app.gitRun the following to install the dependencies:
$ yarn installRun the following to run the sample app locally:
$ yarn devThe sample app is now running at: http://localhost:3011/.
After you generate an API key for the sandbox environment, enter it on the settings tab on the top right corner of the sample app.
You are now ready to use the sample app and test some payments flows. In a production environment these payments would settle in the USDC stablecoin.
To automatically trigger certain responses from the Circle Payments API, you can use some pre-defined test card numbers that exercise specific behaviors.
By default the API base url will be set to https://api-sandbox.circle.com.
If you would like to point to another API base url you need to create a .env file in the project's root folder and configure it as follows:
$ echo BASE_URL=https://[base-url.com] > .envDev tools to confirm SNS subscription / receive notifications can be found (here)[https://github.com/circlefin/payments-sample-app/tree/master/devtools]
This sample app was written with Nuxt. For a more detailed explanation of how Nuxt works, check the Nuxt.js docs.
The sample app uses jest for testing. You can find the tests in the test folder.
To run the tests:
$ yarn testTo watch the tests:
$ yarn test:watch