Skip to content

Getting started

To start developing against the Rapyd Authorization API you must first obtain a username (MsgSenderID) and password ( MsgSenderAP) to access the API, which is provided by a Rapyd implementation specialist.

Sending transactions

  • HTTP Method: POST
  • Headers: Content-Type:application/x-www-form-urlencoded
  • Encoding: UTF-8
  • Url: [UAT/Production url]/process
  • Body: Parameters are encoded in key-value tuples separated by '&', with a '=' between the key and the value. This will make up the content body for the POST method. See Parameter definitions

UAT url is https://authorization.acquiring.uat.valitor.com, production url will be provided by a Rapyd implementation specialist.

/process can process authorizations (0100), advices (0120), reversals (0400) and network management message (

0800) messages. See MsgType in parameter definitions.

Get connected

// code is compatible with .net8 console app
using System.Web;
using Microsoft.Extensions.DependencyInjection;

var service = new ServiceCollection();
service.AddHttpClient();

var client = service.BuildServiceProvider().GetService<IHttpClientFactory>()!.CreateClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://authorization.acquiring.uat.valitor.com/process");
request.Content = new FormUrlEncodedContent(new Dictionary<string, string>
{
{ "MsgType", "0800" },
{ "MsgSenderID", "[insert your username]" },
{ "MsgSenderAP", "[insert your password]" },
{ "MsgID", "123456" },
{ "MsgCode", "900" }
});

var response = await client.SendAsync(request);

if (response.IsSuccessStatusCode)
{
    var content = await response.Content.ReadAsStringAsync();
    var responseParameters = HttpUtility.ParseQueryString(content);
    if (responseParameters["ResponseCode"] == "00"){
        // Success 
    }
}
else
{
    // Handle error
}

    curl -i
    --header "Content-Type:application/x-www-form-urlencoded"
    --request POST
    --data "MsgType=0800&MsgSenderID=[insert your username]&MsgSenderAP=[insert your password]&MsgID=123456&MsgCode=900"
    https://authorization.acquiring.uat.valitor.com/process

Response http body example:

MsgType=0810&MsgID=123456&ResponseSource=A&ResponseCode=00

See more examples:

Some libraries help you with the construction of a parameterized string, such as RestSharp for C# in .NET. Similar libraries are available in most programming languages.

Test cases

Here you can find examples of payment requests for many scenarios to help you to integrate the authorization host to your payment solution.

https://documenter.getpostman.com/view/34438199/2sB3WwrJ1n