- Omit redirect_url from the authorization request
- Present the UI with the Push JS SDK's UX, which detects completion for you] B -- No --> D{Is the user accessing the payment page via a
native mobile app?} D -- Yes --> E[**Use redirect**
- Set redirect_url parameter in authorization request
- Open the authentication URL in the device's default system browser
] D -- No --> F[Default to the SDK's UX
Omit redirect_url] ``` ## Sandbox testing Work through the following against the sandbox host (`sandbox.pushcash.com`) before requesting production access: * Register each user only once and reuse their `id` on subsequent transactions * Simulate an approved transaction using test card `5555 5555 5555 4444` * Simulate a declined transaction using test card `5999 9919 6976 9266` * Test an authentication-required (`202 Accepted`) response using test card `6011 0009 9013 9424`, and confirm you persist the intent `id` and present the authentication UI at `url` * Test a payment decline after the user completes authentication using test card `5999 9819 6976 9283` * Add a new card, then submit a second transaction using the stored `credential_id` * Verify that only `secure_debit` credentials are presented for withdrawals * Process a withdrawal (`cash_out`) with a `secure_debit` card, then authorize with `approval_mode: manual` and approve the pending intent * Refund an approved intent, and test a partial refund by specifying an `amount` less than the original intent amount * Test a refund decline by processing an intent with test card `5999 9619 6976 9301` and then submitting a refund ## Next steps Now that you can process card payments, set up webhooks to receive asynchronous updates on the final payment result — see the [enabling webhooks](./enabling-webhooks) guide. # Changelog Source: https://docs.pushcash.com/changelog Product updates and announcements
Push Widget Quickstart
``` ```js app.js theme={null} const widgetUrl = document.getElementById('widget-url'); const tokenizeButton = document.getElementById('tokenize-button'); const result = document.getElementById('result'); let widget; // Render (or re-render) the widget whenever a URL is entered. widgetUrl.addEventListener('input', () => { if (widget) { widget.destroy(); widget = undefined; } tokenizeButton.disabled = true; if (!widgetUrl.value.trim()) return; widget = new window.PushCash.Widget({ selector: '#widget-container', url: widgetUrl.value.trim(), // Enable the button once the card details are valid. onValid: () => { tokenizeButton.disabled = false; }, }); }); // Exchange the card details for a token. tokenizeButton.addEventListener('click', async () => { try { const { token } = await widget.tokenize(); result.textContent = 'Token: ' + token; } catch (err) { result.textContent = 'Tokenization failed: ' + err.message; } }); ``` Then: 1. Open `index.html` directly in your browser. You'll need an internet connection so the SDK can load from the CDN. 2. Paste the `url` from the previous step into the **Widget URL** field and verify the card form appears. 3. Enter the approved sandbox test card `5555 5555 5555 4444`. Use any future date for expiration and any 3-digit value for CVV. 4. Click **Generate token**. The page displays a `token` — copy it for the next step. ## 3. Authorize the payment Submit the `token` to [authorize-payment](./apireference/authorization/authorize-payment) with the payment details to process the transaction: ```bash theme={null} curl --request POST \ --url https://sandbox.pushcash.com/authorize \ --header 'Authorization: Bearer '$APIKEY \ --header 'Content-Type: application/json' \ --data ' { "amount": 2500, "currency": "USD", "direction": "cash_in", "token": "token_mbDRHFi3dxIZEtykHsgUGC" } ' ``` A `200 OK` response confirms the payment was approved: ```json theme={null} { "id": "intent_sandbox_mbDRHFi3dxIZEtykHsgUGC", "amount": 2500, "direction": "cash_in", "currency": "USD", "credential": { "id": "cred_7YlA9IiSl8UZvNwNSbFajV", "display_name": "Visa 4444", "last4": "4444" } } ``` Congratulations, you've processed your first payment 🎉 ## Next steps * Build the production flow (including processing stored credentials, handling step-up authentication, support for withdrawals and refunds) with the [Card Payments](./card-payments) guide. # React Native SDK Source: https://docs.pushcash.com/react-native-sdk React Native bindings for the Push platform: a `
## Push JS SDK Reference
The SDK must be loaded as a script tag on your website — it cannot be statically bundled via package management.
```html theme={null}
```
Card Processing
Guaranteed debit transactions, no chargeback liability, authorization rates competitors can't match.
Guides
Saving Declined Transactions
No processor switch or changes to your payments stack. Bolt-on logic for recovering declined card transactions.
Guides
Infrastructure
The plumbing that keeps Card Processing and ACH Save operating smoothly.
Guides