Skip to main content

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 NameValue
Content-Type"application/json"
Accept"application/json"

Request Parameters

PropertyPresenceTypeDescription
creedo_payment_idMandatoryStringUnique Payment ID returned in the response of the Create Payment API.
verification_inputMandatoryStringAccepts a Transaction ID, CBU, CVU, DNI, CUIL, or CUIT. The system will automatically detect and validate the type based on its structure.

Success Response Parameters

PropertyTypeDescription
gateway_statusString"accepted"

Error Response Parameters

PropertyTypeDescription
gateway_statusString"rejected"
messageStringError 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",
"verification_input": "20255322089",
}

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.