Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. App calls /transact with the account number they want to lookup in the details object. auth.type is expected to be null token, account_number.

  2. Provider responds with any of the completion codes Successful or Failed.

...

Code Block
languagejson
{
  "request_ref":"{{request_ref}}", 
  "request_type":"lookup_cards",
  "auth": {
    "type": nulltoken,
    "secure": null"9327691266219107,
    "auth_provider": "BeeceptorMasterPass",
    "route_mode": null
  },
  "transaction": {
    "mock_mode": "live", 
    "transaction_ref": "{{transaction_ref}}", 
    "transaction_desc": "A random transaction", 
    "transaction_ref_parent": null, 
    "amount": 0,
    "customer":{
    	"customer_ref": "{{customer_id}}", // Major Parameter to be used on the provider
    	"firstname": "Uju",
        "surname": "Usmanu",
    	"email": "ujuusmanu@gmail.com",
    	"mobile_no": "234802343132"
    },
    "meta":{
    	"a_key":"a_meta_value_1",
    	"another_key":"a_meta_value_2"
    },
    "details": {
 null
  	"account_number":"3065570057"
    }
  }
}

Response

Code Block
languagejson
{
    "status": "Successful",
    "message": "Transaction processed successfully",
    "data": {
        "provider_response_code": "00",
        "provider": "Beeceptor",
        "errors": null,
        "error": null,
        "provider_response": {
            "cards": [
                {
                  "brand": "MASTERCARD",
                  "expiry": "0521",
                  "fundingMethod": "DEBIT",
                  "issuer": "FISERV SOLUTIONS, LLC",
                  "number": "511111xxxxxx1118",
                  "scheme": "MASTERCARD"
                },
            ],
            "reference": "000022200225154318222333334432",
            "meta":{
              "field_key":"field_value",
              "field_key":"field_value"
            }
        }
    }
}

Breakdown of the

...

auth type

For this service, the details object will have auth type can be any of the following:

Field

Type

Requirement

Description

token

string

required

Expect auth.secure to be Mastercard generated token. Eg. 9327691266219107

account_number

stringnumeric

optional

The account number to lookup.required

Expect auth.secure to be an actual account number Eg. 3065570057

msisdn

numerci

required

Expect auth.secure to be a valid telco msisdn Eg. 2347065514172

Possible status response codes

...