> For the complete documentation index, see [llms.txt](https://apis.seerbit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apis.seerbit.com/api-endpoints/pay-with-ussd.md).

# Pay with USSD

## /payments/initiates

<mark style="color:green;">`POST`</mark> `https://seerbitapi.com/api/v2/payments/initiates`

#### Headers

| Name                                            | Type   | Description      |
| ----------------------------------------------- | ------ | ---------------- |
| authorization<mark style="color:red;">\*</mark> | String | Bearer Token     |
| content-type<mark style="color:red;">\*</mark>  | String | application/json |

#### Request Body

| Name                                               | Type   | Description                                                                   |
| -------------------------------------------------- | ------ | ----------------------------------------------------------------------------- |
| publicKey<mark style="color:red;">\*</mark>        | String | This is the merchant public key.                                              |
| amount<mark style="color:red;">\*</mark>           | String | This is the amount to be paid.                                                |
| email<mark style="color:red;">\*</mark>            | String | This is the email of the customer.                                            |
| country<mark style="color:red;">\*</mark>          | String | This is the country from which the transaction is been carried out from       |
| paymentReference<mark style="color:red;">\*</mark> | String | This is the unique identifier for a transaction, to be generated by merchant. |
| mobileNumber<mark style="color:red;">\*</mark>     | String |                                                                               |
| fullName<mark style="color:red;">\*</mark>         | String |                                                                               |
| currency<mark style="color:red;">\*</mark>         | String |                                                                               |
| callbackUrl<mark style="color:red;">\*</mark>      | String |                                                                               |
| redirectUrl<mark style="color:red;">\*</mark>      | String |                                                                               |
| paymentType<mark style="color:red;">\*</mark>      | String |                                                                               |
| bankCode<mark style="color:red;">\*</mark>         | String |                                                                               |

{% tabs %}
{% tab title="200: OK Successful" %}

```javascript
{
  "status": "SUCCESS",
  "data": {
    "code": null,
    "payments": {
        "paymentReference": "dsffererer",
        "linkingReference": "CSEERBIT724622561618580872054",
        "providerreference": "8206",
        "ussdDailCode": "*901*000*8206#"
    },
    "message": null
  }
}
```

{% endtab %}

{% tab title="cURL" %}

```javascript
curl --location 'https://seerbitapi.com/api/v2/payments/initiates' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ENCRYPTION_KEY' \
--data-raw '{
    "publicKey":"YOUR_PUBLIC_KEY",
    "amount":"100",
    "fullName": "FirstName LastName",
    "mobileNumber": "customer mobile number",
    "email":"firstname@mail.com",
    "currency": "NGN",
    "country": "NG",
    "paymentReference": "dsffererer",
    "callbackUrl": "http://yourdomain.com",
    "redirectUrl": "http://yourdomain.com",
    "paymentType": "USSD",
    "bankCode":"044"
  }'
```

{% endtab %}
{% endtabs %}