Making Mock Transactions and API calls

Mocking Card Transactions

In order to successfully test card transactions, we have compiled a list of test cards that can be used to make mock payments.

{
  "card_issuer": "MASTERCARD",
  "auth_type": "PIN",
  "card_number": "5531886652142950",
  "cvv": "564",
  "expiry_date": "09/32",
  "pin": "3310",
  "otp": "12345"
}
{
  "card_issuer": "MASTERCARD",
  "auth_type": "PIN",
  "card_number": "5399838383838381",
  "cvv": "470",
  "expiry_date": "10/31",
  "pin": "3310",
  "otp": "12345"
}
{
    "card_issuer": "MASTERCARD",
    "auth_type": "3DS",
    "card_number": "5438898014560229",
    "cvv": "564",
    "expiry_date": "10/31",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "VISA",
    "auth_type": "3DS",
    "card_number": "4187427415564246",
    "cvv": "828",
    "expiry_date": "09/32",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "VISA",
    "auth_type": "3DS",
    "card_number": "4242424242424242",
    "cvv": "812",
    "expiry_date": "01/31",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "VERVE INTERNATIONAL",
    "auth_type": "PIN",
    "card_number": "5061460410120223210",
    "cvv": "780",
    "expiry_date": "12/31",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "VISA",
    "auth_type": "NOAUTH_AVS",
    "card_number": "4556052704172643",
    "cvv": "899",
    "expiry_date": "09/32",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "MASTERCARD",
    "auth_type": "PREAUTH",
    "card_number": "5377283645077450",
    "cvv": "789",
    "expiry_date": "90/31",
    "pin": "3310",
    "otp": "12345"
}

Mocking Failed Card Transactions

If you would like to test any Provider Errors, You can use the cards in this section.

{
    "card_issuer": "MASTERCARD",
    "error_message": "Declined",
    "card_number": "5143010522339965",
    "cvv": "276",
    "expiry_date": "08/32",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "MASTERCARD",
    "error_message": "Fraudulent",
    "card_number": "5590131743294314",
    "cvv": "887",
    "expiry_date": "11/32",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "MASTERCARD",
    "error_message": "Insufficient Funds",
    "card_number": "5258585922666506",
    "cvv": "883",
    "expiry_date": "09/31",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "MASTERCARD",
    "error_message": "Invalid Transaction",
    "card_number": "5551658157653822",
    "cvv": "276",
    "expiry_date": "08/31",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "MASTERCARD",
    "error_message": "Function Not Permitted to Cardholder",
    "card_number": "5258582054729020",
    "cvv": "887",
    "expiry_date": "11/30",
    "pin": "3310",
    "otp": "12345"
}
{
    "card_issuer": "MASTERCARD",
    "error_message": " Incorrect PIN",
    "card_number": "5399834697894723",
    "cvv": "883",
    "expiry_date": "09/31",
    "pin": "3310",
    "otp": "12345"
}

Mocking Transfers

When transfers are done to the test accounts provided on the test environment, they always remain in a pending state. To mock failed and successful transfers you would need to pass an identifier in your reference, see how to do that below.

Mocking Successful Transfers

  1. Pass _PMCK as a suffix to your reference, this allows us know it's a mock transfer e.g. merchantreg0293039_PMCK. This always creates a mock transfer that would have it's status as successful.
  2. Specify the time interval you want the response/callback to come. To do this, append DU_{minutes} as a suffix e.g. merchant837484758_PMCKDU_1 would return a callback for a successful transfer after 1 minute.

Mocking failed Transfers

  1. Pass _PMCK_ST_F as a suffix to your reference, this allows us know it's a mock failed transfer e.g. merchantreg0297754_PMCK_ST_F. This always creates a failed mock transfer.
  2. Specify the time interval you want the response/callback to come. To do this, append DU_{minutes} as a suffix e.g. merchant837484758_PMCK_ST_FDU_1 would return a callback for a failed transfer after 1 minute.

Test Bank Accounts

Here is a collection of test accounts that can be used to mock Transfers.

{
    "account_bank": "044",
    "account_number": "0690000031",
    "account_name": "Forrest Green",
    "otp": "12345"
}
{
    "account_bank": "044",
    "account_number": "0690000032",
    "account_name": "Pastor Bright",
    "otp": "12345"
}
{
    "account_bank": "044",
    "account_number": "0690000033",
    "account_name": "Bale Gary",
    "otp": "12345"
}
{
    "account_bank": "044",
    "account_number": "0690000034",
    "account_name": "Ade Bond",
    "otp": "12345"
}

Mocking Bill Payments

Here are some credentials to help you test some billers

BillerCredential TypeCredentials
DSTVSmart card number0025401100
EKEDCMeter number1101160434535

The Biller type for making mock DSTV payments is DSTV Payment

Loading...