---
title: "Initiate Payment"
method: POST
path: "/merchant-collection/mobile_payment/initiate"
tags: ["Apple Pay and Google Pay"]
---

# Initiate Payment

`POST /merchant-collection/mobile_payment/initiate`

This endpoint is used to initiate an Apple Pay or Google Pay collection. 

 **Notes:**

- Please be advised that access to this API is available upon request. To initiate this process, kindly send an email to **support@payaza.africa**. You will be granted access once our team reviews and approves your request. 

- Ensure that the Check Transaction Status API using the merchant reference is used for your transaction status checks which can be found [here](/api-reference/check-transaction-statusmerchant-reference/check-transaction-statusmerchant-reference).

## Request body

- InitiatePaymentRequest
  - `amount` number, required — The amount to be charged.
  - `first_name` string, required — The customer's first name.
  - `last_name` string, required — The customer's last name..
  - `email_address` string, required — The customer's email address.
  - `payment_option` string, required — **APPLEPAY** or **GOOGLEPAY**.
  - `description` string, required — The description of this transaction.
  - `transaction_reference` string, required — The unique identifier of this transaction.
  - `redirect_url` string, uri, required — URL to redirect on successsful.
  - `cancel_url` string, uri, required — URL to redirect when user cancels.
  - `error_url` string, uri, required — URL to redirect on failed payment.
  - `country_code` string, required — The country code. (ISO 3166-1 alpha-3).
  - `currency_code` string, required — **GBP**, **EUR** and **USD**.

## Response `200`

Initiate Payment Successful Response

- InitiatePaymentResponse
  - `status` boolean — Request status.
  - `message` string — Response message.
  - `data` object — Payment initialization details.
    - `error_url` string, uri — Redirect URL in case of error.
    - `merchant_reference` string — The merchant's unique reference for the transaction.
    - `payment_option` string — Selected payment method.
    - `transaction_amount` number — Amount to be charged.
    - `slug_name` string — Slug identifier for the merchant or checkout page.
    - `currency` string — Currency code.
    - `paymentUrl` string, uri — The URL where the user should be redirected to complete payment.
    - `transaction_reference` string — Unique transaction reference.
    - `cancel_url` string, uri — Redirect URL if the user cancels.
    - `redirect_url` string, uri — Redirect URL upon success.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/revisions/1ecd4b94ff07/schema)