Submit Payment

The Submit Payment API allows merchants to submit a payment request. This process involves generating a payment ID that can be used to execute the payment. Through this API, a payment creation request is received by Creedo. Upon validation of customer's provided information, the payment request will be approved.

Endpoint

Request URL: https://apihit.net/api/payment/submitV2

Request Headers

Header Name	Value
Content-Type	"application/json"
Accept	"application/json"

Request Parameters

Property	Presence	Type	Description
creedo_payment_id	Mandatory	String	Unique Payment ID returned in the response of the Create Payment API.
transaction_id	Mandatory	String	Unique identifier assigned to a transaction by the payment method upon successful completion. Used for tracking and verification.
customer_bank_account_no	Optional	String	Bank account number or wallet number from which the customer sent the payment to the bank_account_no provided in the Create Payment API request.

Success Response Parameters

Property	Type	Description
gateway_status	String	"accepted"

Error Response Parameters

Property	Type	Description
gateway_status	String	"rejected"
message	String	Error message here.

Request Body

POST /api/payment/submitV2 HTTP/1.1
Host: https://apihit.net
Content-Type: application/json
Accept: application/json

{
    "creedo_payment_id": "3C8HL0MHX9",
    "transaction_id": "TAP63SAS",
    "customer_bank_account_no": "01712345678"
}

Success Response

A successful response will return a JSON object containing:

{
  "gateway_status": "accepted"
}

Error Response

In case of an error, the API will return a JSON object with error details:

{
    "gateway_status": "rejected",
    "message": "Unknown error occurred."
}

Notes

• The merchant_payment_id must be unique for each transaction to prevent duplication.