Versions Compared

Key

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

With this service, the calling apps can get list of financial institutions with their corresponding codes. Apps will collect authorisation details and forward to OnePipe to execute, OnePipe will in turn forward to the provider’s dedicated implementation. The provider will return a list of all financial institutions available.

Info

Before you proceed: Please read this.

...

Gliffy
macroId
imageAttachmentIdatt181239815
macroIdd52fb001-9cb0-4572-b4f8-69873883b98c
baseUrlhttps://onepipe.atlassian.net/wiki
d52fb001-9cb0-4572-b4f8-69873883b98cnameOnePipe 2.0 Lookup NUBAN Service
diagramAttachmentIdatt181436417
containerId150044770
timestamp1582630159960

...

Code Block
languagejson
{
  "request_ref":"{{request_ref}}", 
  "request_type":"get_banks",
  "auth": {
    "type": null, 
    "secure": null,
    "auth_provider": "Beeceptor",
    "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}}",
    	"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
  }
}

...

Code Block
languagejson
{
    "status": "Successful",
    "message": "Transaction processed successfully",
    "data": {
        "provider_response_code": "00",
        "provider": "Beeceptor",
        "errors": null,
        "error": null,
        "provider_response": {
            "banks": [
                {
                    "bank_cbn_code": "050",
                    "bank_nip_code": "090270",
                    "bank_name": "Ecobank Bank"
                },
                {
                    "bank_cbn_code": "214",
                    "bank_nip_code": "000270",
                    "bank_name": "FCMB"
                },
                {
                    "bank_cbn_code": "313",
                    "bank_nip_code": "000070",
                    "bank_name": "Mkudi"
                },
                {
                    "bank_cbn_code": "401",
                    "bank_nip_code": "107019",
                    "bank_name": "ASOSavings"
                },
                {
                    "bank_cbn_code": "917",
                    "bank_nip_code": "100016",
                    "bank_name": "GOWANS MFB"
                }
            ],
            "reference": "000022200225154318222333334432",
            "meta":{
              "field_key":"field_value",
              "field_key":"field_value"
            }
        }
    }
}

Possible status response codes

...