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. |
| verification_input | Mandatory | String | Accepts 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
| 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",
"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_idmust be unique for each transaction to prevent duplication.