Novatti Payments API (Payment Acquiring v1.0)

Download OpenAPI specification:

Introduction

Novatti Payments is one of the most current and comprehensive payment platforms available in the market. This API documentation provides technical information about integrating to Novatti Payments. Where applicable, it provides links to our guides and provides more business context.

Direct Debit

A Direct Debit flow differs from a regular payment flow as an order has to be created instead of a payment request.

For the Direct Debit flow, merchants do not interact with the customers. Instead, merchants have the customer's bank account details and proceed to create an order with the relevant order details. The payment will then be initiated via bank account deduction.

object
object
{
  • "Header": {
    },
  • "Order": {
    }
}
object
{
  • "Result": {
    }
}
Response Code Response Message
200 OK
400 Invalid Request
500 Internal Error

Direct Debit Refund

Refunds for Direct Debit payments are also submitted as orders with the reference to the original Direct Debit Transaction. When a refund request is submitted, based on the state of the original payment, either a cancellation or refund occurs. If the original transaction has not been initiated for processing by the merchant's bank, the direct debit transaction will be cancelled and there will not be any fund transfers. If the transaction is been accepted by the bank and being processed, transaction cannot be refunded and merchant needs to wait until it is fully processed. If the transaction is fully processed and settled then refund request can be submitted.

Partial Refund Requests are accepted until the total amount for of the refund requests do not exceed the original transaction amount. However, partial refund are only possible after the original transaction has been fully processed and settled.

object
object
{
  • "Header": {
    },
  • "Order": {
    }
}
object
{
  • "Result": {
    }
}
Response Code Response Message
200 OK
400 Invalid Request
500 Internal Error

WeChat Pay

A payment order needs to be created via the Alternate Payments endpoint to initiate a WeChat Pay transaction.

object
object
{
  • "Header": {
    },
  • "Order": {
    }
}
object
{
  • "Result": {
    }
}

Alipay

A payment order needs to be created via the Alternate Payments endpoint to initiate an Alipay transaction.

object
object
{
  • "Header": {
    },
  • "Order": {
    }
}
object
{
  • "Result": {
    }
}

Alipay-Web

A payment order needs to be created via the Alternate Payments endpoint to initiate an Alipay-Web transaction.

object
object
{
  • "Header": {
    },
  • "Order": {
    }
}
object
{
  • "Result": {
    }
}

Alipay-InApp

A payment order needs to be created via the Alternate Payments endpoint to initiate an Alipay-InApp transaction.

object
object
{
  • "Header": {
    },
  • "Order": {
    }
}
object
{
  • "Result": {
    }
}

UnionPay

A payment order needs to be created via the Alternate Payments endpoint to initiate a UnionPay transaction.

object
object
{
  • "Header": {
    },
  • "Order": {
    }
}
object
{}