KotlinPaymongo

Paymongo client for kotlin

Feature

• Create Source - DSL supported
• Create payment
• Create payment method - DSL supported
• Create payment intent
• Create webhook
• Get source by id
• Get payment by id
• Get payment method by id
• Get payment intent by id and or client key
• Attach payment intent
• Get webhook
• Get webhooks
• Enable/Disable webook

API Reference

https://developers.paymongo.com/reference

Usage

val config = Paymongo.DefaultConfig.apply{
    secretKey = "sk_123456"
}
val client = Paymongo(config)

// create a source via DSL
val source = client.createSource {
   type = Source.Type.GCash // Source.Type.GrabPay
   amount = 10000 // 100.00
   redirectSuccess = successUrl
   redirectFailed = failedUrl
   billing = Billing(
      name = "Full name",
      phone = "09xxxxxxxxx",
      email = "sample@email.com,
      address = Address(
          line1 = "",
          line2 = "",
          state = "",
          postalCode = "",
          city = "",
          country = ""
      )
   )
}
// TODO - more sample 

Ktor Webhook Integration

// http://localhost/paymongo/events
fun Route.payMongo() { 
    route("paymongo") {
        post("events") {
            processWebhookEvent(call)
        }
    }
}
// sample webhook process
// see instruction how to secure webhook 
// https://developers.paymongo.com/docs/creating-webhook#3-securing-a-webhook-optional-but-highly-recommended
suspend fun processWebhookEvent(call: ApplicationCall) {
    val jsonString = call.receiveText()
    val webhookEvent = AppJson.decodeFromString<ReceiveWebhookEvent>(jsonString)
    val signature = call.request.header("Paymongo-Signature")
    if (signature == null) {
        call.respond(HttpStatusCode.Unauthorized, "Missing Paymongo-Signature")
    } else {
        // signature verification
        val sign = signature.split(",")
        val t = sign[0].replace("t=", "").toLong() // timestamp
        val te = sign[1].replace("te=", "") // test mode
        val li = sign[2].replace("li=", "") // live mode
        val attributes = webhookEvent.data.attributes
        val liveMode = attributes.liveMode
        val signatureFromPayload = "$t.$jsonString"
        val signatureFromHeader = if (liveMode) {
            li
        } else {
            te
        }
        val webhookSecretKey = "" // created webhook secret key
        // hash signature
        val hashedSignature = hash(content = signatureFromPayload, key = webhookSecretKey, algorithm = "HmacSHA256")
        // check for a matching signature
        if (hashedSignature == signatureFromHeader) {
            // process event response here
            when (val data = attributes.data) {
                is Source -> {}
                is Payment -> {}
                else -> {}
            }
            call.respond(HttpStatusCode.OK, "Webhook OK")
        } else {
            call.respond(HttpStatusCode.Unauthorized, "Invalid signature")
        }
    }
}

Installation

repositories { 
    mavenCentral()
    maven { url = uri("https://s01.oss.sonatype.org/content/repositories/snapshots") }
}

Dependency

implementation("io.github.ronjunevaldoz:kpaymongo-jvm:1.0.0-SNAPSHOT"){
  isChanging = true // this will allow to get all latest changes
}