Corda Payments SDK

With the Corda Payments SDK you can build and deploy payment-enabled CorDapps on your network. Use this documentation to add all the required Payments SDK dependencies to an existing CorDapp. Once the dependencies have been added to your CorDapp, it can be configured to initiate payments, via the network’s Payments Agent.

You must have access to:

The CorDapps that make up the Corda Payments solution are made available to Corda Enterprise customers by agreement. Once your Corda account manager has arranged access, you can download the Corda Payments files via the Corda Enterprise Customer Hub.

To install Corda Payments Technical Preview, go to the Corda Customer Hub.

The Corda Payments SDK dependencies can be added to an existing CorDapp, making it possible to trigger all the required flows for payments to be made and received on your network.

To add the Corda Payments SDK:

  1. Add a variable for the payments release group and the version you wish to use and set the Corda version:
buildscript {
    ext {
        corda_release_version = '4.8.5'
        corda_payments_release_group = "com.r3.payments"
        corda_payments_release_version = "1.0.0-TechPreview-1.2"
    }
}
  1. Add payment jars to project by replacing [payment_jar_location] with location of downloaded files
repositories {
    maven { url "https://software.r3.com/artifactory/r3-corda-releases"}
    flatDir { dir [payment_jar_location] }
}
  1. In your workflows build.gradle add:
    cordaCompile "$corda_payments_release_group:payments-sdk:$corda_payments_release_version"
    cordaCompile "$corda_payments_release_group:payments-contracts:$corda_payments_release_version"
  1. To use the deployNodes task, add these dependencies to your root build.gradle file:
    cordapp "$corda_payments_release_group:payments-sdk:$corda_payments_release_version"
    cordapp "$corda_payments_release_group:payments-contracts:$corda_payments_release_version"
  1. Add the dependencies to the deployNodes task with the following syntax:
nodeDefaults {
    projectCordapp {
        deploy = false
    }
        cordapp "$corda_payments_release_group:payments-sdk:$corda_payments_release_version"
        cordapp "$corda_payments_release_group:payments-contracts:$corda_payments_release_version"
}
  1. Specify the default agent in your node config by adding:
cordapp("$corda_payments_release_group:payments-sdk:$corda_payments_release_version") {
    config """
    {
        "payments" : {
            "agent" : "O=Agent,L=New York,C=US"
        }
    }
        """
}

You have added the Corda Payments dependencies to your existing CorDapp. You can now use a local network with a Payments Agent node to explore Corda Payments in action.

Was this page helpful?

Thanks for your feedback!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.

We're sorry this page wasn't helpful. Let us know how we can make it better!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Create an issue

Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.