Go Live

This guide walks you through the steps to take your Push integration live. As a prerequisite, you should have completed the integration and received your production key.

Examples in this guide call the production API hosted at https://api.pushcash.com and trigger real money-movement.

Overview

After developing your integration in sandbox, there are a few remaining steps to enable live money-movement. For a primer on how Push models money-movement, check out the Settlement reference guide.

Configure Accounts

Our banking partner may require that your payments flow through multiple settlement accounts to ensure compliance with OFAC / AML policies. If this requirement applies, you will be required to tag payments with the relevant settlement account ID.

Call the list-accounts to retrieve the accounts available to your organization.

curl -X GET https://api.pushcash.com/account/list \
  -H 'Authorization: Bearer '$PUSH_API_KEY

If the response from the endpoint contains only a single account, you can skip the next step - your payments will automatically be tagged with the correct account. If the response contains multiple accounts, you must submit the correct account for each payment intent you create.

example create-intent request body

{
  "amount": 1000,
  "currency": "USD",
  "direction": "cash_in",
  "account_id": "The account ID"  // settlement account for the payment
}

Enable transaction reconciliation

After settling transactions, Push will deliver a report via email with the details of the settled payments. This report should be used to reconcile your operational account and confirm the receipt of funds from activity on the platform. To enable your team to identify the corresponding internal transactions for each settled payment, submit your user ID in the tag field passed to create-user.

example create-user request body

{
    "name": {
        "first": "John",
        "last": "Doe"
    },
    "tag": "your internal user ID"
    ... // other fields omitted for brevity
}

The emailed report will include the user tag in the table for each settled transaction.

Deploy to Production

You are now ready to take your integration live. Make sure you have provided the updated values for the webhook_url and redirect_url in your integration, and that you have updated the API Key to the production key.