Remittance Payments
As a PostaPay merchant,you are able to request for card payments.
Endpoint: https://sandbox.postapay.app/api/v1/remittances/remittance-payments/
Request Parameters
Field | Type | Description | Examples |
---|---|---|---|
MerchantCode | Number | A unique number assigned to an organization/merchant registered with ViewTech, through which payment is received | "2*****8" |
MerchantTransactionReference | Alpha-Numeric | A unique reference for the transaction | "TESTVX1239".00 |
DestinationChannelCode | Number | A unique number that identifies the receiving body | "63902" |
DestinationChannelName | String | The receiving body name | "M-PESA " |
Currency | Numeric | The type of currency to be transacted | "KES " |
Amount | Numeric | The amount pf money to be remitted | "100000" |
ReceiverPhoneNumber | String | The Phone number of the recipient of the remittance funds | "25****6614677 " |
ReceiverAccountNumber | Numeric | The Account which the remittance is made to | "25****6614677 " |
ReceiverAccountName | String | The user receiving the remitted amount | "John Doe" |
ForeignCurrency | Number | This is enabled if the merchant wants the customer to pay via postapay wallet. | "USD,1 " |
SenderPhoneNumber | Number | The sender phone number | "25477***104 " |
SenderName | String | The name of the person remitting money | "John Doe " |
SenderDOB | Number | This is the sender date of birth | "2020-08-08 " |
SenderCountryISO | String | This is the unique identifier for each country | "GB " |
SenderNationality | String | The sender's nationality | "British " |
SenderIDType | String | This is the sender identification | "National ID" |
SenderIDNumber | Number | The SenderIDType Number | "123***78 " |
SenderServiceProviderName | String | The platform the sender is using for payments | "PostaPay Remit " |
RemittancePurpose | String | The reason for payment | "pay for servives " |
CallbackURL | Url | This is the URL where PostaPay will send the results after the payment process is initiated. | "https://example.com/callbacks " |
Remarks | String | Description of the transaction being performed | "Test " |
Channel Codes
Channel Codes
CodeEntity Name
- 00 PostaPay
- 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
Headers
Key: Authorization
Value: Bearer cFJZcjZ6anEwaThMMXp6d1FETUxwWkIzeVBDa2hNc2M6UmYyMkJmWm9nMHFRR2xWOQ==
Body:
{
"MerchantCode":"600980",
"MerchantTransactionReference":"TESTVX1239",
"DestinationChannelCode":"63902",
"DestinationChannelName":"M-PESA",
"Currency":"KES",
"Amount":"150",
"ReceiverPhoneNumber":"25****6614677",
"ReceiverAccountNumber":"25****6614677",
"ReceiverAccountName":"Jane Doe",
"ForeignCurrency":"USD,1",
"SenderPhoneNumber":"25477***104",
"SenderName":"John Doe",
"SenderDOB":"2020-08-08",
"SenderCountryISO":"GB",
"SenderNationality":"British",
"SenderIDType":"National ID",
"SenderIDNumber":"123***78",
"SenderServiceProviderName":"PostaPay Remit",
"RemittancePurpose":"Test",
"CallbackURL":"https://example.com/callbacks",
"Remarks": "Test"
}
Response Sample
Field | Type | Description | Example |
---|---|---|---|
status | Numeric | This 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 |
detail | String | A description of the response status sent by PostaPay API. | "Transaction of KSH50 to 2547*677 is being processed" |
RequestID | String | An identifier for the transaction request returned by PostaPay upon successful request submission. This is generated by PostaPay API. | "4040359-0f8****1-4779-85b3-44e575166f7a" |
ResponseCode | Numeric | This 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 |
CheckoutRequestID | Alpha-Numeric | A unique identifier of the transaction request | "763df0f8-a815-40f5-b13f-cdb4632793e6" |
TransactionCharges | String | This 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
Field | Type | Description | Example |
---|---|---|---|
MerchantCode | Number | A unique number assigned to an organization/merchant registered with ViewTech, through which payment is received (can be Paybill or Till number) | “2*****8” |
DestinationChannel | String | This name of entity channel where the funds are sent. | "MPESA" |
RecipientName | String | This full name of the customer receiving the funds. | "John Kym Doe" |
RecipientAccountNumber | String | This account number where the funds are received | "2547*******7" |
ResultCode | Numeric | The numeric status of the results, sent to the callback url | 0 means success, while any other code indicates that an error occurred. The specific error is describe in the ResultDesc field |
ResultDesc | String | This 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." |
SourceChannel | String | The name of the entity channel from where the funds transfer is initiated | "PostaPay" |
PostaPayTransactionCode | String | This is the transaction code from PostaPay | "CRVSUVGIRP" |
CheckoutRequestID | String | This is a unique PostaPay transaction ID for every payment request. Same value is sent to the customer over SMS upon successful processing. | "6f3ebd0d-b892-4c4e-952a-f3eea030af85" |
PostaPayTransactionID | JSON Object | This is a unique PostaPay 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 |
TransactionAmount | Number | This is the amount that was transacted. It is usually returned under the ResultParameter array. | "10.00" |
MerchantRequestID | Decimal | The unique id sent with the transaction request from the Merchant system | "25*******77" |
MerchantTransactionReference | Decimal | A unique identifier of the transaction generated by the Merchant system. | "254******77" |
TransactionDate | String | This is the date and time that the transaction completed PostaPay. | "20220305103101" |
MerchantAccountBalance | Decimal | This 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": "PostaPay",
"PostaPayTransactionCode" : "CRVSUVGIRP",
"TransactionDate": "20220305103101",
"TransactionAmount": "10.00",
"PostaPayTransactionID": "PR52",
"MerchantTransactionReference": "254******77",
"MerchantAccountBalance": "564.00"
}