# Payment

The RequestPayment is a request to debit mobile money from subscribers account. Partners must code the App based on the API field requirements so that the App can send correct requests accordingly.

### BENIN

\
Endpoint URI:

`Mtn`

```url
POST {baseUrl}/QosicBridge/user/requestpayment
```

`Moov`

```
POST {baseUrl}/QosicBridge/user/requestpaymentmv
```

Celtiis

```
POST {baseUrl}/QosicBridge/sb/v1/requestpayment
```

***

### TOGO

`Togocel`

```
POST {baseUrl}/QosicBridge/user/requestpayment
```

`Moov Togo`

```
POST {baseUrl}/QosicBridge/tg/v1/requestpayment
```

***

## <mark style="color:blue;">Body request and  response format</mark>&#x20;

{% tabs %}
{% tab title="Request" %}

```json
Content-Type: application/json[Basic Authentication headers]

{     	
     "msisdn": "22967370249",
     "amount": "100",
     "firstname":"Fabro",
     "lastname":"Bi",
     "transref" :"12340890000",
     "clientid": "*****" 
}
```

{% endtab %}

{% tab title="Response format" %}

```json
{
    "responsecode": number,
    "responsemsg": string,
    "transref": number | string,
    "serviceref": null, (this line is not include in Togo response format)
    "comment": string | null
}
```

{% endtab %}

{% tab title="Success response format" %}

```json
{
    "responsecode": "01",
    "responsemsg": "Succesfull",
    "transref": "12340890r000",
    "serviceref": "7427291567",
    "comment": null
}
```

{% endtab %}

{% tab title="Error response format" %}

```json
{
  
    "title": "Internal Server Error",
    "status": 500,
    "detail": "message"
}
```

{% endtab %}
{% endtabs %}

<pre><code><strong>
</strong></code></pre>

<table data-full-width="false"><thead><tr><th width="133">Element</th><th width="226">Type</th><th>Decription</th></tr></thead><tbody><tr><td>msisdn</td><td><mark style="color:orange;"><code>string:MANDATORY</code></mark></td><td>Subscriber’s account i.e. 229 67******</td></tr><tr><td>amount</td><td><mark style="color:orange;"><code>string:MANDATORY</code></mark></td><td>Transaction amount i.e. 100</td></tr><tr><td>firstname</td><td><mark style="color:orange;"><code>string:OPTIONAL</code></mark></td><td>Firstname of the subscribe</td></tr><tr><td>lastname</td><td><mark style="color:orange;"><code>string:OPTIONAL</code></mark></td><td>Lastname of the subscriber</td></tr><tr><td>transref</td><td><mark style="color:orange;"><code>string:MANDATORY</code></mark></td><td>Unique transaction reference. To be used as unique identifier in call to request for a payment.</td></tr><tr><td>clientid</td><td><mark style="color:orange;"><code>string:MANDATORY</code></mark></td><td>A unique generated id for each third-party application. This id is generated by Qos and should be included in all payment requests.</td></tr></tbody></table>
