Skip to main content

Remittance Payments

As a SasaPay merchant,you are able to request for card payments.

Alt test Endpoint:

Request Parameters

MerchantCodeNumberA unique number assigned to an organization/merchant registered with ViewTech, through which payment is received"2*****8"
MerchantTransactionReferenceAlpha-NumericA unique reference for the transaction"TESTVX1239".00
DestinationChannelCodeNumberA unique number that identifies the receiving body"63902"
DestinationChannelNameStringThe receiving body name"M-PESA "
CurrencyNumericThe type of currency to be transacted"KES "
AmountNumericThe amount pf money to be remitted"100000"
ReceiverPhoneNumberStringThe Phone number of the recipient of the remittance funds"25****6614677 "
ReceiverAccountNumberNumericThe Account which the remittance is made to"25****6614677 "
ReceiverAccountNameStringThe user receiving the remitted amount"John Doe"
ForeignCurrencyNumberThis is enabled if the merchant wants the customer to pay via sasapay wallet."USD,1 "
SenderPhoneNumberNumberThe sender phone number"25477***104 "
SenderNameStringThe name of the person remitting money"John Doe "
SenderDOBNumberThis is the sender date of birth"2020-08-08 "
SenderCountryISOStringThis is the unique identifier for each country"GB "
SenderNationalityStringThe sender's nationality"British "
SenderIDTypeStringThis is the sender identification"National ID"
SenderIDNumberNumberThe SenderIDType Number"123***78 "
SenderServiceProviderNameStringThe platform the sender is using for payments"SasaPay Remit "
RemittancePurposeStringThe reason for payment"pay for servives "
CallbackURLUrlThis is the URL where SasaPay will send the results after the payment process is initiated." "
RemarksStringDescription of the transaction being performed"Test "

Channel Codes

Channel Codes

CodeEntity Name

  • 00 SasaPay
  • 01 KCB
  • 02 Standard Chartered Bank KE
  • 03 Absa Bank
  • 07 NCBA
  • 10 Prime Bank
  • 11 Cooperative Bank
  • 12 National Bank
  • 14 M-Oriental
  • 16 Citibank
  • 18 Middle East Bank
  • 19 Bank of Africa
  • 23 Consolidated Bank
  • 25 Credit Bank
  • 31 Stanbic Bank
  • 35 ABC Bank
  • 36 Choice Microfinance Bank
  • 43 Eco Bank
  • 50 Paramount Universal Bank
  • 51 Kingdom Bank
  • 53 Guaranty Bank
  • 54 Victoria Commercial Bank
  • 55 Guardian Bank
  • 57 I&M Bank
  • 61 HFC Bank
  • 63 DTB
  • 65 Mayfair Bank
  • 66 Sidian Bank
  • 68 Equity Bank
  • 70 Family Bank
  • 72 Gulf African Bank
  • 74 First Community Bank
  • 75 DIB Bank
  • 76 UBA
  • 78 KWFT Bank
  • 89 Stima Sacco
  • 97 Telcom Kenya
  • 63902 MPesa
  • 63903 AirtelMoney
  • 63907 T-Kash
Sample post request
Key: Authorization
Value: Bearer cFJZcjZ6anEwaThMMXp6d1FETUxwWkIzeVBDa2hNc2M6UmYyMkJmWm9nMHFRR2xWOQ==
"ReceiverAccountName":"Jane Doe",
"SenderName":"John Doe",
"SenderIDType":"National ID",
"SenderServiceProviderName":"SasaPay Remit",
"Remarks": "Test"

Response Sample

statusNumericThis is a boolean true or false status that indicates the outcome of the response. true means success and false means transaction failed or intermittent error occured.true
detailStringA description of the response status sent by SasaPay API."Transaction of KSH50 to 2547*677 is being processed"
RequestIDStringAn identifier for the transaction request returned by SasaPay upon successful request submission. This is generated by SasaPay API."4040359-0f8****1-4779-85b3-44e575166f7a"
ResponseCodeNumericThis is a numeric status code that indicates the status of the response. 0 means success and any other code means an error occurred or the request failed.0
CheckoutRequestIDAlpha-NumericA unique identifier of the transaction request"763df0f8-a815-40f5-b13f-cdb4632793e6"
TransactionChargesStringThis is the charges for the transaction."Transaction of KSH50 to 2547*677 is being processed."
Sample response
"status": true,
"detail": "Transaction is being processed",
"ResponseCode": "0",
"RequestID": "2612-333c5306-****-43e4-8edb-1c63372ed886",
"MerchantRequestID": "128338358",
"TransactionCharges": "0.00"

Results Response

MerchantCodeNumberA unique number assigned to an organization/merchant registered with ViewTech, through which payment is received (can be Paybill or Till number)“2*****8”
DestinationChannelStringThis name of entity channel where the funds are sent."MPESA"
RecipientNameStringThis full name of the customer receiving the funds."John Kym Doe"
RecipientAccountNumberStringThis account number where the funds are received"2547*******7"
ResultCodeNumericThe numeric status of the results, sent to the callback url0 means success, while any other code indicates that an error occurred. The specific error is describe in the ResultDesc field
ResultDescStringThis is a message from the API that gives the status of the request processing and usually maps to a specific result code value."Transaction processed successfully."
SourceChannelStringThe name of the entity channel from where the funds transfer is initiated"SasaPay"
SasaPayTransactionCodeStringThis is the transaction code from SasaPay"CRVSUVGIRP"
CheckoutRequestIDStringThis is a unique SasaPay transaction ID for every payment request. Same value is sent to the customer over SMS upon successful processing."6f3ebd0d-b892-4c4e-952a-f3eea030af85"
SasaPayTransactionIDJSON ObjectThis is a unique SasaPay transaction ID for every payment request. Same value is sent to the customer over SMS upon successful processing. It is usually returned under the ResultParameter array.PR52
TransactionAmountNumberThis is the amount that was transacted. It is usually returned under the ResultParameter array."10.00"
MerchantRequestIDDecimalThe unique id sent with the transaction request from the Merchant system"25*******77"
MerchantTransactionReferenceDecimalA unique identifier of the transaction generated by the Merchant system."254******77"
TransactionDateStringThis is the date and time that the transaction completed SasaPay."20220305103101"
MerchantAccountBalanceDecimalThis is the available balance of the Charges Paid account under the B2C MerchantCode used in the transaction.564.00
sample result response
"MerchantCode": "6***0",
"DestinationChannel": "MPESA",
"RecipientName": "Johh Kym Doe",
"RecipientAccountNumber": "2547*******7",
"ResultCode": 0,
"CheckoutRequestID": "6f3ebd0d-b892-4c4e-952a-f3eea030af85",
"MerchantRequestID": "25*******77",
"ResultDesc": "Transaction processed successfully.",
"SourceChannel": "SasaPay",
"SasaPayTransactionCode" : "CRVSUVGIRP",
"TransactionDate": "20220305103101",
"TransactionAmount": "10.00",
"SasaPayTransactionID": "PR52",
"MerchantTransactionReference": "254******77",
"MerchantAccountBalance": "564.00"