Changelog
What changed in the Partner API and these docs.
2026-11
- Electronic records consent. The pay page asks the customer once to agree to receive records electronically (disclosures, receipts and notices) before they pay by card or bank transfer (ACH debit and bill payments are not asked), and asks again after the consent is withdrawn in the customer's profile or by your staff on the customer's page (Electronic records, then Record withdrawal), or when the consent text changes.
- Receipts. The WhatsApp payment message of a transfer paid on its pay page links the receipt (payment-link payments do not get the link), and the paid pay page shows a printable receipt.
- AML holds before payout. Each corridor can hold transfers for review before payout for structuring, a large first transfer, or a large transfer to a new recipient. Your admins set the rules on the Settings page, with two-step verification. On live money, transactions may be held for review (
compliance_statusflagged) by these rules, Partner API ones included. - Compliance block version
2. Settlement instructions now sendcompliance.version2, withscreening.names_screened(how many names the screen covered, by role) and a newcompliance.fundingobject (how the sender's money was collected:mode,provider,reference,status,amount,currency). Accept any version of 1 or more and ignore keys you do not know. An instruction is never sent without its block, and never unsigned. See Webhooks. - Sender address and date of birth. On a real-money transfer the
originatormay carryaddressanddate_of_birthwhen the travel rule asks for them.POST /transactionsaccepts optionalsender.addressandsender.date_of_birth. - Legacy-only callbacks refused. A status callback signed only with the older
x-signatureheader is refused with401. Sign callbacks withx-smartremit-signature. Our instructions still carry both headers. - Amount required on
paid_out. Apaid_outwithoutamount.destinationanddestination_currencyis refused with422and"error": "amount_required". Nothing is saved, so send it again with the amount.422"error": "reference_unresolved"is a defensive refusal: a correctly signed callback that names a real transfer never gets it. A callback with a reference we cannot resolve gets401, because we check the signature with the key of the transfer the reference names. - Refunds of partner-collected funds. A refund of a real-money transfer whose funds you collected reaches your rail as a signed reverse with
"method": "partner_collected", when SmartRemit holds the record of its settlement instruction to your rail after you went live. 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) gets no reverse: SmartRemit staff arrange that return with you. See Funding.
2026-10
- AI apps can manage repeat payments. Three new MCP tools:
list_schedules,create_schedule(every month or every week, to a saved recipient in India) andchange_schedule(pause, resume or cancel). They need the new scopeschedules:manage; an app connected before this change asks the customer to connect again. The AI app still cannot pay: each due day sends the customer a pay link on WhatsApp, which they pay on the SmartRemit pay page with their code. The portal shows which app set up each repeat payment. See AI apps (MCP). - One docs site. These guides and the API reference are now the SmartRemit docs at
smartremit.ai/docs, linked from the site header. They replace the older single-page partner guide, whose content moved into the guides and the API reference. Old links to the preview address go to the same page. New sections: Getting started (where SmartRemit is today, creating a transaction) and Webhooks (the compliance block,client_referenceandpayout_reference). - AI app sign-in fix. Allow on the SmartRemit sign-in page now connects the app. Before, the page answered "This link does not work".
- AI apps can prepare a transfer. Two new MCP tools:
prepare_transferprepares a transfer to a saved recipient and returns the pay link, andcancel_prepared_transfercancels one that is not paid. They need the new scopetransfers:prepare. The AI app still cannot pay: the customer pays on the SmartRemit pay page with a code sent to their WhatsApp, and the page says which app prepared the transfer. A prepared transfer pays only the recipient's saved account; nobody can change the account on the pay page. Customers can also senddisconnect appsto SmartRemit on WhatsApp or Telegram. See AI apps (MCP). - AI apps (MCP), early access. A SmartRemit customer can connect Claude, ChatGPT or Perplexity to their own account through SmartRemit's MCP server, for invited customers only. The tools look up quotes, send limits, saved recipients (masked) and the customer's own transfers. They cannot send or pay. See AI apps (MCP).
- Reason for "other". When
purposeisother,POST /transactionsnow requirespurpose_detail: the sender's reason in their own words, 10 to 120 characters that say what the money is for. A missing, too short, too long or meaningless value is refused with422before theIdempotency-Keyis bound, so a corrected retry with the same key succeeds. When the reason names one of the other purposes (for example "school fees"), the transaction takes that purpose and keeps the reason. With any other purpose,purpose_detailis ignored. It comes back aspurpose_detailin every answer, to the partner that owns the transaction only (nullwhen none was given). SmartRemit checks every reason, and some transactions are held for review (compliance_statusflagged). - Required purpose.
POST /transactionsnow requirespurpose: why the money is sent, one offamily_support,gift,education,medical,savings,bills,businessorother. A missing or unknown value is refused with422before theIdempotency-Keyis bound, so a corrected retry with the same key succeeds. It comes back aspurposein every answer (nullon a transaction made before this change) and is in the settlement instruction'scomplianceobject. Sandbox transactions need it too. - New documentation preview. These guides and an API reference generated from the Partner API's OpenAPI description.
- Order references. Send your own order number as
client_referencewhen you create a transaction. It comes back in every answer and in the settlements statement, and it is in the settlement instruction when your own rail pays the transaction out. Apaid_outstatus callback may sendpayout_reference(for example a bank UTR); it is saved once and returned aspayout_reference.
2026-09
- Test keys and scopes. Keys are now live (
sr_live_…) or test (sr_test_…), and each endpoint needs one scope. A test key works only with sandbox transactions, which never reach a real payout rail. - Per-key rate limit. Each key now has its own per-minute budget, inside the per-partner one.
- Settlements statement.
GET /settlementslists your paid and delivered transfers for reconciliation, as JSON or CSV. - Timestamped signatures. Instructions and callbacks are signed with
x-smartremit-signature(timestamp plus HMAC), with an overlap window when a secret is rotated. The olderx-signatureheader is deprecated. - Compliance block. Settlement instructions carry an additive
complianceobject. - Sender name. A transaction created without
sender.nameis held for manual review. - Idempotency hardening. The transaction is bound to its
Idempotency-Keybefore it is created, reserved key prefixes are refused, and a masked payout account is refused. - Unpaid expiry. A transaction left unpaid is cancelled after a fixed period.
- Exchange rates fail safely. A quote or transaction is refused with
503rather than priced on a stale or missing rate. - Settlement endpoint rules. Settlement endpoints must be public HTTPS hosts; redirects and acknowledgement sizes are limited.
2026-06
- Partner API v1. Key authentication, per-partner rate limit, and the corridors, quote, beneficiaries and transactions endpoints.
- Webhook-driven settlement. Signed settlement instructions to your rail and signed status callbacks back, with automatic retries.
- Rates.
PUT /ratesandGET /rateslet you push a wholesale rate per corridor. - Any-to-any corridors.
destination_countryon quotes and transactions.