1. 5.Pay In(Collection)
Boost MFB
EN
  • EN
  • 中文
  • 1. Introduction
  • 2. Response Codes
  • 3. Test Account Data
  • 4. API Rules
    • 4.1 Security Specification
  • 5.Pay In(Collection)
    • 5.1 Pay In Result Notification
    • Create Order
      POST
    • Query PayIn Result
      POST
  • 6. Payout
    • Pay Out Result Notification
    • Create Order (Pay Out)
      POST
    • Query Pay Out Result
      POST
  • 7. Validate
    • Name Enquiry
      POST
  • 8.Merchant
    • queryMerchantBalance
      POST
  • 9. Institution List
    • Bank List
      POST
  • 10. Virtual Account
    • Credit Notification
    • Credit Result Query
      POST
    • Create Virtual Account
      POST
    • Query Virtual Account Detail
      POST
    • Update Virtual Account Status
      POST
    • Update Virtual Account Name
      POST
    • Query Virtual Account List
      POST
  1. 5.Pay In(Collection)

5.1 Pay In Result Notification

When a Pay In transaction is completed, the platform sends a notification to the merchant

Notification Parameters#

FieldTypeWhether RequiredLengthExampleDescription
transIdstringNo32B6864C218481468FBEB2640DB11078ADTransaction serial number
transTypeStringYes3203Trans Type;03:PayIn
merchantOrderIdStringYes32AC71EC46019F49BBA7B61176E96843B4External merchant's order ID
merchantNoStringYes3200000002Merchant number
statusintYes21Order status, 0: Initialized, 1: Success, 2: Failure, 3: Pending
requestAmountLongYes-10000Requested amount
payAmountLongNo-10000Actual payment amount, 0 if payment has not been initiated
feeLongNo-100Handling fee, 0 if payment has not been initiated
payeeAmountLongNo-9900Actual received amount, 0 if payment has not been initiated
payerAccNoStringNo32-Payer's account number, in the channel payment account
payerNameStringNo32-Payer's name
accountNoStringYes329900592334Virtual account number for collection
narrationStringYes--narration
countryCodeStringYes-NGCountry code
currencyStringYes-NGNCurrency type
beginTimeTimestampNo-1732672968000Transaction time
endTimeTimestampNo-1732672968000Transaction completion time
errorCodeStringNo--Error code
errorMessageStringNo--Error message
createTimeTimestampYes-1732672968000Creation time
updateTimeTimestampYes-1732672968000Update time
Success
{
	"transType": "03",
	"merchantOrderId": "NG62202508290813111",
	"merchantNo": "00000028",
	"status": 1,
	"requestAmount": 1000000,
	"payAmount": 1000000,
	"fee": 9500,
	"payeeAmount": 990500,
	"payerAccNo": "8107943600",
	"payerName": "LIANG FANG",
	"accountNo": "9900000090",
        "narration": "Transfer from RISIKAT TITILOPE AIGORO",
	"countryCode": "NG",
	"currency": "NGN",
	"beginTime": 1756451631000,
	"endTime": 1756451643000,
	"transId": "0E738AE8B77C47FE8F23DED40257FDE8",
	"sessionId": "100033250829071350928138509554",
	"createTime": 1756451592000,
	"updateTime": 1756451643000
}
Failure
{
	"transType": "03",
	"merchantOrderId": "NG62202508290809311",
	"merchantNo": "00000028",
	"status": 2,
	"requestAmount": 9150000,
	"payAmount": 0,
	"fee": 0,
	"payeeAmount": 0,
	"payerAccNo": "9900000088",
	"accountNo": "9900000088",
	"countryCode": "NG",
	"currency": "NGN",
	"endTime": 1756453200000,
	"errorCode": "MO_07",
	"errorMessage": "Order has been closed",
	"createTime": 1756451372000,
	"updateTime": 1756453200000
}
Previous
4.1 Security Specification
Next
Create Order
Built with