Jump to Content
Mambu Payments (formerly Numeral)
GuidesAPI ReferenceChangelog
Log inContact usMambu Payments (formerly Numeral)
API Reference
Log inContact us
GuidesAPI ReferenceChangelog

Numeral API

  • Getting started
  • Environments
  • Authentication
  • Sign API requests
  • Webhooks
  • Verify webhooks
  • Rate limiting
  • Idempotency
  • Status codes
  • API versioning
  • Data types
    • Standard data types
    • Currency codes and decimals
  • Pagination
  • Metadata
  • Reason and purpose codes
    • SEPA reason codes
    • Bacs reason codes
    • FPS reason codes
    • Purpose codes

Payments

  • Payment orders
    • Payment order object
    • Payment order lifecycle
    • Create payment orderpost
    • List payment ordersget
    • Approve payment orderpost
    • Cancel payment orderpost
    • Retry payment orderpost
    • Update payment order validationpost
    • Update payment orderpost
    • Retrieve payment orderget
  • Incoming payments
    • Incoming payment object
    • Incoming payment lifecycle
    • Confirm incoming paymentpost
    • Reject incoming paymentpost
    • Update incoming paymentpost
    • Update incoming payment validationpost
    • Retrieve incoming paymentget
    • List incoming paymentsget
  • Returns
    • Return object
    • Return lifecycle
    • Create returnpost
    • List returnsget
    • Retrieve returnget
    • Update returnpost
    • Approve returnpost
    • Cancel returnpost

Investigations

  • Return requests
    • Return request object
    • Return request lifecycle
    • Create return requestpost
    • List return requestsget
    • Accept return requestpost
    • Deny return requestpost
    • Retrieve return requestget
  • Claims
    • Claim object
    • Claim lifecycle
    • Create claimpost
    • List claimsget
    • Retrieve claimget
  • Inquiries
    • Inquiry object
    • Inquiry lifecycle
    • Deny inquirypost
    • Create inquirypost
    • List inquiriesget
    • Retrieve inquiryget

Accounts

  • Connected accounts
    • Connected account object
    • List connected accountsget
    • Retrieve connected accountget
  • Transactions
    • Transaction object
    • Transaction lifecycle
    • List transactionsget
    • Update transactionpost
    • Retrieve transactionget
  • Balances
    • Balance object
    • Balance lifecycle
    • List balancesget
    • Retrieve balanceget

Counterparties

  • Account holders
    • Account holder object
    • Account holder lifecycle
    • Create account holderpost
    • List account holdersget
    • Disable account holderpost
    • Update account holderpost
    • Retrieve account holderget
  • External accounts
    • External account object
    • External account lifecycle
    • Create external accountpost
    • List external accountsget
    • Approve external accountpost
    • Deny external accountpost
    • Disable external accountpost
    • Verify external accountpost
    • Update external accountpost
    • Retrieve external accountget
  • Internal accounts
    • Internal account object
    • Internal account lifecycle
    • Create internal accountpost
    • List internal accountsget
    • Block internal accountpost
    • Unblock internal accountpost
    • Disable internal accountpost
    • Retrieve internal accountget
    • Update an internal accountpost
  • Direct debit mandates
    • Direct debit mandate object
    • Direct debit mandate lifecycle
    • Create direct debit mandatepost
    • List direct debit mandatesget
    • Update direct debit mandatepost
    • Retrieve direct debit mandateget
    • Disable direct debit mandatepost
    • Block direct debit mandatepost
    • Authorize direct debit mandatepost

Reconciliations

  • Expected payments
    • Expected payment object
    • Expected payment lifecycle
    • Create expected paymentpost
    • List expected paymentsget
    • Cancel expected paymentpost
    • Update expected paymentpost
    • Retrieve expected paymentget
  • Payment captures
    • Payment capture object
    • Payment capture lifecycle
    • Create payment capturepost
    • List payment capturesget
    • Cancel payment capturepost
    • Update payment capturepost
    • Retrieve payment captureget
  • Reconciliations
    • Reconciliation object
    • Reconciliation lifecycle
    • Create reconciliationpost
    • List reconciliationsget
    • Cancel reconciliationpost
    • Update reconciliationpost
    • Retrieve reconciliationget

Files

  • Files
    • File object
    • File lifecycle
    • Approve filepost
    • Cancel filepost
    • List filesget
    • Retrieve fileget
    • Download fileget

Verification of Payee

  • Payee verification requests
    • Payee verification request object
    • Payee verification request lifecycle
    • Send verification payee requestpost
    • List payee verification requestsget
    • Retrieve payee verification requestget
    • Simulate incoming payee verification requestpost
  • Verification scheme participants
    • Get supported identification types for a payee accountget
    • Retrieve verification scheme participantget

Events

  • Events
    • Event object
    • Event lifecycle
    • Retry failed eventspost
    • List eventsget
    • Retrieve eventget
    • Resend eventpost

Tools

  • Connectivity syncs
    • Connectivity sync object
    • Connectivity sync lifecycle
    • List connectivity syncsget
    • Retrieve connectivity syncget
  • Audit trails
    • Audit trail object
    • List audit trailsget
    • Retrieve audit trailget
  • Process payments
    • Process paymentspost
  • Bulk actions
    • Bulk action object
    • Bulk action lifecycle
    • Create bulk actionpost
    • List bulk actionsget
    • Retrieve bulk actionget
    • Retrieve bulk action related itemsget
  • Custom fields
    • Custom field object
    • Create custom fieldpost
    • List custom fieldsget
    • Update custom fieldpost
    • Retrieve custom fieldget
  • Payment retry rules
    • Payment retry rule object
    • List payment retry rulesget
    • Retrieve payment retry ruleget
  • Bank code lookup
    • Bank code lookup overview
    • Bank code lookuppost
  • Bank simulator
    • Simulate message receivedpost
    • Update payment statuspost
    • Create balancepost
    • Create transactionpost
    • Create incoming paymentpost
  • Platform health check
    • Check platform healthget

Additional resources

  • Account details
  • Address
  • Organization identifications
  • Private identification
  • External account verification

Reason and purpose codes

Learn about reason and purpose codes supported in Mambu Payments (formerly Numeral)

Different payment schemes use different reason codes to reject, return, or indicate the purpose of a payment. Learn more about:

  • SEPA reason codes
  • Bacs reason codes
  • FPS reason codes
  • Purpose codes