Funding
Collecting sender funds on your own account.
Who collects the sender's money
SmartRemit never holds funds. For each partner, SmartRemit records how the sender's money is collected before live transfers start. A SmartRemit admin sets this funding mode on the partner's go-live record; it is one of two:
- You collect (
partner_collected). You collect the sender's money on your side, then tell SmartRemit the transfer is paid by confirming it through the API withPOST /transactions/{id}/confirm. Your settlement instruction follows. - Your payment provider (
partner_psp). The sender pays by card on the SmartRemit pay page, and the charge is made in your own Stripe account. SmartRemit stores only a restricted Stripe key (one that startsrk_live_orrk_test_) for your account, never a full secret key. Any other key is refused, and card payments stay off until a restricted key is stored.
A transfer whose funding does not match your recorded mode is not instructed: it waits for our operations team, who resolve it with you.
When a customer asks you to withdraw the consent to electronic records, record it on the customer's page (Customers, then the customer, then Electronic records, then Record withdrawal). After that, the next card or bank-transfer payment on the pay page asks the customer again. ACH debit and bill payments are not asked.
What your rail sees
Every settlement instruction carries compliance.funding (see Webhooks):
mode:partner_collectedorpartner_psp(andpartner_pullwhen your rail pulls the funds with the instruction).provider:partnerorstripe.reference: the Stripe charge id forpartner_psp, otherwisenull. It is alwaysnullon a transfer routed to another partner's rail.status,amount(the total charge, amount plus fee) andcurrency.
It carries no card or bank digits and no personal data.
Refunds
A refund of a transfer you collected yourself reaches your rail as a signed reverse instruction with "method": "partner_collected", when SmartRemit holds the record of its settlement instruction to your rail after you went live: return the sender's money on your side. For any other transfer you collected (for example one for which SmartRemit holds no record of a settlement instruction to your rail, one that was settled before you went live, or one that another partner pays out), no reverse is sent and SmartRemit staff arrange the return with you. SmartRemit cannot refund a partner_psp card payment yet: refund it in your own Stripe dashboard. SmartRemit does not record that refund. While a transfer has an open refund request, SmartRemit sends no new payout instruction for it, but an instruction already sent to a rail can still be paid out, and any other transfer that has not been paid out yet can still be paid out. Ask SmartRemit staff before you refund a transfer that has not been delivered.