Versions Compared

Key

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

...

  1. App calls /transact with the right auth details

  2. Provider responds with WaitingForOTP or PendingValidation as may be required

  3. App calls /transact/validate to supply OTP if needed

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

  5. To query the status of a transaction, the app can call /transact/query

  6. Where the provider supports it, the app can call /transact/reverse to request a reversal

Gliffy
imageAttachmentIdatt32243723
macroIda9d3d285-2916-4123-9e93-236a130f390f
baseUrlhttps://onepipe.atlassian.net/wiki
nameOnePipe 2.0 Collect Service
diagramAttachmentIdatt32210953
containerId32243713
timestamp1582651977768

INTERFACE SPECIFICATION (APP → ONEPIPE)

...

Code Block
languagejson
{
  "request_ref":"{{request_ref}}", 
  "request_type":"lookup_wallet_mid",
  "auth": {
    "type": "bank.account | card", 
    "secure": "{{encrypted_secure}}",
    "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",
    	"b_key":"a_meta_value_2"
    },
    "details": {
    	"otp_override": true
    }
  }
}

...

Code Block
languagejson
{
    "status": "Successful",
    "message": "Transaction processed successfully",
    "data": {
        "provider_response_code": "00",
        "provider": "Beeceptor",
        "errors": null,
        "error": null,
        "provider_response": {
            "customer_id": "007935125",
            "account_name": "BOLA SALAMI",
            "first_name": "BOLA",
            "last_name": "SALAMI",
            "middle_name": "-",
            "gender": "Male",
            "account_currency": "NGN",
            "dob": "yyyy-MM-dd-HH-mm-ss",
            "scheme_code": "STFCUR",
            "account_status": "ACCOUNT OPEN",
            "account_number": "1780161243",
            "bvn": "22153578379",
            "mobile_number": "09081690629",
            "reference": "000022200225154318222333334432",
            "meta":{
              "field_key":"field_value",
              "field_key":"field_value"
            }
        }
    }
}

Request (validate with otp)

...