Versions Compared

Key

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

With this service, the calling apps can do a transfer to a destination account number from a pre-configured account of the app. If authorisation details are required by a provider, apps will have to provide this. OnePipe will in turn forward to the provider’s dedicated implementation. This is a service that is useful for when a business wants to debit their own account and credit any destination account.

Info

Before you proceed: Please read this.

...

Gliffy
imageAttachmentIdatt214401071
macroIdcebdb7a4-0850-4656-82ea-399089fb01b0
baseUrlhttps://onepipe.atlassian.net/wikimacroIdcebdb7a4-0850-4656-82ea-399089fb01b0
nameFunds Transfer I
diagramAttachmentIdatt210501979
containerId210337809
timestamp1583771820658

...

Gliffy
imageAttachmentIdatt204603605
macroIdc76356e6-127f-46ad-bb8a-94ba9a4d0f11
baseUrlhttps://onepipe.atlassian.net/wikimacroIdc76356e6-127f-46ad-bb8a-94ba9a4d0f11
nameFunds Transfer 2
diagramAttachmentIdatt214007834
containerId210337809
timestamp1583742263404

...

Code Block
languagejson
{
  "request_ref":"{{request_ref}}", 
  "request_type":"disburse",
  "auth": {
    "type": null"bank.account", 
    "secure": null"{{encrypted}}",
    "auth_provider": "BeeceptorGTBank",
    "route_mode": null
  },
  "transaction": {
    "mock_mode": "live", 
    "transaction_ref": "{{transaction_ref}}", 
    "transaction_desc": "A random transaction", 
    "transaction_ref_parent": null, 
    "amount": 1000,
    "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": {
    	"destination_account":"2363262632",
        "destination_bank_code":"011",
    	"otp_override": true
    }
  }
}

Response (when otp_override = false)

...

Code Block
languagejson
{
    "status": "Successful",
    "message": "Transaction processed successfully",
    "data": {
        "provider_response_code": "00",
        "provider": "Beeceptor",
        "errors": null,
        "error": null,
        "provider_response": {
            "reference": "000022200225154318222333334432",
            "payment_id": "136FTTP200590171",
            "destination_institution_code": "000016",
            "beneficiary_account_name": "JOHN DOE JAMES",
            "beneficiary_account_number": "3056433222",
            "beneficiary_kyc_level": "3",
            "originator_account_name": "James Jane",
            "originator_account_number": "0001131256",
            "originator_kyc_level": "1",
            "narration": "My narration",
            "transaction_final_amount": 1000,
            "meta":{}
        }
    }
}

Request (validate with otp)

...