Create CC Transaction

Creates a new Credit Card payment request and returns the checkout/payment URLs to redirect the customer to the payment gateway.

Endpoint

POST /api/v1/transaction/create

Headers

Header Type Required Description
Content-Type string Yes application/json
X-API-KEY string Yes The API key provided by Manjo

Request Body Parameters

Field Type Required Description
method int Yes Must be 4 (the enum value for Credit Card).
amount float Yes The total transaction amount.
additional_info object Yes Container for all method-specific fields detailed below.

additional_info Fields

Field Type Required Description
customer_name string Yes The name of the customer making the payment.
account_email string Yes Customer's email address.
account_phone string Yes Customer's phone number.
currency string Yes ISO 4217 currency code (e.g., IDR).
redirect_url string Yes The URL the customer will be redirected to after completing payment at the gateway.
description string Optional Product details or description of product.
callback_url string Optional The merchant webhook URL that will receive payment success notifications.
expired_date string Optional Expiry date of the payment link in ISO 8601 format with timezone offset (e.g., 2026-12-31T23:59:59+07:00) or standard local datetime format.

Example Request

{
  "method": 4,
  "amount": 150000,
  "additional_info": {
    "customer_name": "John Doe",
    "account_email": "johndoe@example.com",
    "account_phone": "081234567890",
    "description": "Subscription Plan",
    "currency": "IDR",
    "callback_url": "https://webhook.site/your-webhook-url",
    "redirect_url": "https://your-frontend.com/success",
    "expired_date": "2026-12-31T23:59:59+07:00"
  }
}

Example Response

HTTP 200 - Success

{
  "success": true,
  "message": "Transaction created successfully",
  "data": {
    "amount": 150000,
    "channel_type": "CREDIT_CARD",
    "created_at": "2026-07-01T09:42:44.408625858+07:00",
    "currency": "IDR",
    "customer_name": "John Doe",
    "account_email": "johndoe@example.com",
    "expired_date": "2026-12-31T23:59:59Z",
    "external_ref_id": "EXTREF01202607010942441460",
    "merchant_name": "Ayoborong",
    "method": "CreditCard",
    "payment_url": "https://pay.example.com/redirect/v2/payment?tXid=EXTREF01202607010942441460",
    "redirect_url": "https://your-frontend.com/success",
    "status": "PENDING",
    "trx_date": "2026-07-01T09:42:44.408625858+07:00",
    "trx_id": "cmr1h08xk000342qq3fmnl5u1",
    "uid": "bc804633-9f79-4d58-ade9-fa566d8262df"
  },
  "timestamp": "2026-07-01T09:42:44+07:00"
}

Next Steps: Extract the payment_url from the response and redirect the customer to that URL to complete the credit card form.


Error Responses

HTTP 400 - Bad Request

Occurs if required headers or fields are missing or invalid:

{
  "success": false,
  "message": "Payment processing failed. Please try again.",
  "error": {
    "code": "BAD_REQUEST"
  },
  "timestamp": "2026-06-28T19:11:28+07:00"
}

HTTP 401 - Unauthorized

Occurs when the provided X-API-KEY is missing or invalid:

{
  "success": false,
  "message": "invalid api key",
  "error": {
    "code": "UNAUTHORIZED"
  },
  "timestamp": "2026-06-28T19:11:59+07:00"
}

HTTP 403 - Forbidden

Occurs if your account lacks permissions for Credit Card transactions:

{
  "success": false,
  "message": "Access denied. You do not have sufficient privileges to create this transaction type.",
  "error": {
    "code": "FORBIDDEN"
  },
  "timestamp": "2026-06-28T19:10:47+07:00"
}