Real-Time Payments Requests for Payment

Real-Time Payments transfers move funds, within seconds, between your Increase account and any other account on the Real-Time Payments network. A request for payment is a request to the receiver to send funds to your account. The permitted uses of Requests For Payment are limited by the Real-Time Payments network to business-to-business payments and transfers between two accounts at different banks owned by the same individual. Please contact support@increase.com to enable this API for your team.

Events

Your application can listen to webhooks about this resource. The events about Real-Time Payments Requests for Payment will have the categories "real_time_payments_request_for_payment.created" or "real_time_payments_request_for_payment.updated" .

The Real-Time Payments Request for Payment object

{
  "account_id": "account_in71c4amph0vgo2qllky",
  "account_number_id": "account_number_v18nkfqm6afpsrvy82b2",
  "amount": 100,
  "cancellation": null,
  "created_at": "2020-01-31T23:59:59Z",
  "creditor_name": "National Phonograph Company",
  "currency": "USD",
  "debtor": {
    "address": {
      "address_line2": "Unit 2",
      "building_number": "33",
      "city": "New York",
      "country": "US",
      "postal_code": "10045",
      "state": "NY",
      "street_name": "Liberty Street"
    },
    "name": "Ian Crease"
  },
  "debtor_account_number": "987654321",
  "debtor_routing_number": "101050001",
  "expires_at": "2020-02-14T23:59:59Z",
  "fulfillment_inbound_real_time_payments_transfer_id": null,
  "id": "real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7",
  "idempotency_key": null,
  "refusal": null,
  "rejection": null,
  "requested_execution_at": "2020-02-07T23:59:59Z",
  "status": "pending_response",
  "submission": null,
  "type": "real_time_payments_request_for_payment",
  "unstructured_remittance_information": "Invoice 29582"
}

Attributes

account_id

string

The Account in which a successful transfer will arrive.

More about Accounts.

account_number_id

string

The Account Number in which a successful transfer will arrive.

More about Account Numbers.

amount

integer

The transfer amount in USD cents.

cancellation

dictionary

Nullable

If a cancellation has been requested, this will contain supplemental details. The request for payment moves to canceled once the recipient bank acknowledges the cancellation.

created_at

string

The ISO 8601 date and time at which the request for payment was created.

creditor_name

string

The name of the creditor requesting the payment.

currency

enum

The ISO 4217 code for the transfer’s currency. For real-time payments transfers this is always equal to USD.

debtor

dictionary

Details of the person being requested to pay.

debtor_account_number

string

The debtor’s account number, which the request is sent to.

debtor_routing_number

string

The debtor’s American Bankers’ Association (ABA) Routing Transit Number (RTN).

expires_at

string

The ISO 8601 date and time after which the request for payment is no longer valid. After this time the debtor’s bank should no longer allow the debtor to pay it.

fulfillment_inbound_real_time_payments_transfer_id

string

Nullable

The identifier of the Inbound Real-Time Payments Transfer that fulfilled this request.

More about Inbound Real-Time Payments Transfers.

string

The Real-Time Payments Request for Payment’s identifier.

idempotency_key

string

Nullable

The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

refusal

dictionary

Nullable

If the request for payment is refused by the destination financial institution or the receiving customer, this will contain supplemental details.

rejection

dictionary

Nullable

If the request for payment is rejected by Real-Time Payments or the destination financial institution, this will contain supplemental details.

requested_execution_at

string

Nullable

The ISO 8601 date and time by which the payment was requested to be made.

status

enum

The lifecycle status of the request for payment.

submission

dictionary

Nullable

After the request for payment is submitted to Real-Time Payments, this will contain supplemental details.

type

string

A constant representing the object’s type. For this resource it will always be real_time_payments_request_for_payment.

unstructured_remittance_information

string

Unstructured information that will show on the recipient’s bank statement.

List Real-Time Payments Requests for Payment

curl \
  --url "${INCREASE_URL}/real_time_payments_requests_for_payment?account_id=account_in71c4amph0vgo2qllky" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const realTimePaymentsRequestForPayment of client.realTimePaymentsRequestsForPayment.list()) {
  console.log(realTimePaymentsRequestForPayment.id);
}

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
page = client.real_time_payments_requests_for_payment.list()
page = page.data[0]
print(page.id)

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

page = increase.real_time_payments_requests_for_payment.list

puts(page)

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/Increase/increase-go"
	"github.com/Increase/increase-go/option"
)

func main() {
	client := increase.NewClient(
		option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
	)
	page, err := client.RealTimePaymentsRequestsForPayment.List(context.TODO(), increase.RealTimePaymentsRequestsForPaymentListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)
}

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentListPage;
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

        RealTimePaymentsRequestsForPaymentListPage page = client.realTimePaymentsRequestsForPayment().list();
    }
}

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentListPage
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentListParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

    val page: RealTimePaymentsRequestsForPaymentListPage = client.realTimePaymentsRequestsForPayment().list()
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $page = $client->realTimePaymentsRequestsForPayment->list(
    accountID: 'account_id',
    createdAt: [
      'after' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
      'before' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
      'onOrAfter' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
      'onOrBefore' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
    ],
    cursor: 'cursor',
    idempotencyKey: 'x',
    limit: 1,
  );

  var_dump($page);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using Increase.Api;
using Increase.Api.Models.RealTimePaymentsRequestsForPayment;

IncreaseClient client = new();

RealTimePaymentsRequestsForPaymentListParams parameters = new();

var page = await client.RealTimePaymentsRequestsForPayment.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}

Returns a list response :

{
  "data": [
    { /* Real-Time Payments Request for Payment object */ },
    { /* Real-Time Payments Request for Payment object */ }
    /* ... */
  ],
  "next_cursor": "v57w5d",
}

Parameters

account_id

string

Filter Real-Time Payments Requests for Payment to those destined to the specified Account.

More about Accounts.

idempotency_key

string

Filter records to the one with the specified idempotency_key you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

Between 1 and 200 characters

More parameters

Create a Real-Time Payments Request for Payment

curl -X "POST" \
  --url "${INCREASE_URL}/real_time_payments_requests_for_payment" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "account_number_id": "account_number_v18nkfqm6afpsrvy82b2",
    "amount": 100,
    "creditor_name": "National Phonograph Company",
    "debtor": {
      "address": {
        "country": "US",
        "street_name": "Liberty Street"
      },
      "name": "Ian Crease"
    },
    "debtor_account_number": "987654321",
    "debtor_routing_number": "101050001",
    "expires_at": "2020-02-14T23:59:59Z",
    "requested_execution_at": "2020-02-07T23:59:59Z",
    "unstructured_remittance_information": "Invoice 29582"
  }'

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const realTimePaymentsRequestForPayment = await client.realTimePaymentsRequestsForPayment.create({
  account_number_id: 'account_number_v18nkfqm6afpsrvy82b2',
  amount: 100,
  debtor: {
    address: { country: 'US' },
    name: 'Ian Crease',
  },
  debtor_account_number: '987654321',
  debtor_routing_number: '101050001',
  expires_at: '2020-02-14T23:59:59Z',
  requested_execution_at: '2020-02-07T23:59:59Z',
  unstructured_remittance_information: 'Invoice 29582',
});

console.log(realTimePaymentsRequestForPayment.id);

import os
from datetime import datetime
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
real_time_payments_request_for_payment = client.real_time_payments_requests_for_payment.create(
    account_number_id="account_number_v18nkfqm6afpsrvy82b2",
    amount=100,
    debtor={
        "address": {
            "country": "US"
        },
        "name": "Ian Crease",
    },
    debtor_account_number="987654321",
    debtor_routing_number="101050001",
    expires_at=datetime.fromisoformat("2020-02-14T23:59:59"),
    requested_execution_at=datetime.fromisoformat("2020-02-07T23:59:59"),
    unstructured_remittance_information="Invoice 29582",
)
print(real_time_payments_request_for_payment.id)

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

real_time_payments_request_for_payment = increase.real_time_payments_requests_for_payment.create(
  account_number_id: "account_number_v18nkfqm6afpsrvy82b2",
  amount: 100,
  debtor: {address: {country: "US"}, name: "Ian Crease"},
  debtor_account_number: "987654321",
  debtor_routing_number: "101050001",
  expires_at: "2020-02-14T23:59:59Z",
  requested_execution_at: "2020-02-07T23:59:59Z",
  unstructured_remittance_information: "Invoice 29582"
)

puts(real_time_payments_request_for_payment)

package main

import (
	"context"
	"fmt"
	"os"
	"time"

	"github.com/Increase/increase-go"
	"github.com/Increase/increase-go/option"
)

func main() {
	client := increase.NewClient(
		option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
	)
	realTimePaymentsRequestForPayment, err := client.RealTimePaymentsRequestsForPayment.New(context.TODO(), increase.RealTimePaymentsRequestsForPaymentNewParams{
		AccountNumberID: increase.F("account_number_v18nkfqm6afpsrvy82b2"),
		Amount:          increase.F(int64(100)),
		Debtor: increase.F(increase.RealTimePaymentsRequestsForPaymentNewParamsDebtor{
			Address: increase.F(increase.RealTimePaymentsRequestsForPaymentNewParamsDebtorAddress{
				Country: increase.F("US"),
			}),
			Name: increase.F("Ian Crease"),
		}),
		DebtorAccountNumber:               increase.F("987654321"),
		DebtorRoutingNumber:               increase.F("101050001"),
		ExpiresAt:                         increase.F(time.Now()),
		RequestedExecutionAt:              increase.F(time.Now()),
		UnstructuredRemittanceInformation: increase.F("Invoice 29582"),
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", realTimePaymentsRequestForPayment.ID)
}

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestForPayment;
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentCreateParams;
import java.time.OffsetDateTime;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

        RealTimePaymentsRequestsForPaymentCreateParams params = RealTimePaymentsRequestsForPaymentCreateParams.builder()
            .accountNumberId("account_number_v18nkfqm6afpsrvy82b2")
            .amount(100L)
            .debtor(RealTimePaymentsRequestsForPaymentCreateParams.Debtor.builder()
                .address(RealTimePaymentsRequestsForPaymentCreateParams.Debtor.Address.builder()
                    .country("US")
                    .build())
                .name("Ian Crease")
                .build())
            .debtorAccountNumber("987654321")
            .debtorRoutingNumber("101050001")
            .expiresAt(OffsetDateTime.parse("2020-02-14T23:59:59Z"))
            .requestedExecutionAt(OffsetDateTime.parse("2020-02-07T23:59:59Z"))
            .unstructuredRemittanceInformation("Invoice 29582")
            .build();
        RealTimePaymentsRequestForPayment realTimePaymentsRequestForPayment = client.realTimePaymentsRequestsForPayment().create(params);
    }
}

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestForPayment
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentCreateParams
import java.time.OffsetDateTime

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

    val params: RealTimePaymentsRequestsForPaymentCreateParams = RealTimePaymentsRequestsForPaymentCreateParams.builder()
        .accountNumberId("account_number_v18nkfqm6afpsrvy82b2")
        .amount(100L)
        .debtor(RealTimePaymentsRequestsForPaymentCreateParams.Debtor.builder()
            .address(RealTimePaymentsRequestsForPaymentCreateParams.Debtor.Address.builder()
                .country("US")
                .build())
            .name("Ian Crease")
            .build())
        .debtorAccountNumber("987654321")
        .debtorRoutingNumber("101050001")
        .expiresAt(OffsetDateTime.parse("2020-02-14T23:59:59Z"))
        .requestedExecutionAt(OffsetDateTime.parse("2020-02-07T23:59:59Z"))
        .unstructuredRemittanceInformation("Invoice 29582")
        .build()
    val realTimePaymentsRequestForPayment: RealTimePaymentsRequestForPayment = client.realTimePaymentsRequestsForPayment().create(params)
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $realTimePaymentsRequestForPayment = $client
    ->realTimePaymentsRequestsForPayment
    ->create(
    accountNumberID: 'account_number_v18nkfqm6afpsrvy82b2',
    amount: 100,
    debtor: [
      'address' => [
        'country' => 'US',
        'addressLine2' => 'x',
        'buildingNumber' => 'x',
        'city' => 'x',
        'postalCode' => 'x',
        'state' => 'xx',
        'streetName' => 'Liberty Street',
      ],
      'name' => 'Ian Crease',
    ],
    debtorAccountNumber: '987654321',
    debtorRoutingNumber: '101050001',
    expiresAt: new \DateTimeImmutable('2020-02-14T23:59:59Z'),
    requestedExecutionAt: new \DateTimeImmutable('2020-02-07T23:59:59Z'),
    unstructuredRemittanceInformation: 'Invoice 29582',
    creditorName: 'National Phonograph Company',
  );

  var_dump($realTimePaymentsRequestForPayment);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using Increase.Api;
using Increase.Api.Models.RealTimePaymentsRequestsForPayment;

IncreaseClient client = new();

RealTimePaymentsRequestsForPaymentCreateParams parameters = new()
{
    AccountNumberID = "account_number_v18nkfqm6afpsrvy82b2",
    Amount = 100,
    Debtor = new()
    {
        Address = new()
        {
            Country = "US",
            AddressLine2 = "x",
            BuildingNumber = "x",
            City = "x",
            PostalCode = "x",
            State = "xx",
            StreetName = "Liberty Street",
        },
        Name = "Ian Crease",
    },
    DebtorAccountNumber = "987654321",
    DebtorRoutingNumber = "101050001",
    ExpiresAt = DateTimeOffset.Parse("2020-02-14T23:59:59Z"),
    RequestedExecutionAt = DateTimeOffset.Parse("2020-02-07T23:59:59Z"),
    UnstructuredRemittanceInformation = "Invoice 29582",
};

var realTimePaymentsRequestForPayment = await client.RealTimePaymentsRequestsForPayment.Create(parameters);

Console.WriteLine(realTimePaymentsRequestForPayment);

Parameters

account_number_id

string

Required

The identifier of the Account Number where the funds will land.

More about Account Numbers.

amount

integer

Required

The requested amount in USD cents. Must be positive.

creditor_name

string

The name of the creditor requesting the payment. If not provided, defaults to the name of the account’s entity.

Between 1 and 140 characters,

debtor

dictionary

Required

Details of the person being requested to pay.

debtor_account_number

string

Required

The debtor’s account number, which the funds will be requested from.

Between 1 and 34 characters,

debtor_routing_number

string

Required

The debtor’s American Bankers’ Association (ABA) Routing Transit Number (RTN).

Exactly 9 characters,

expires_at

string

Required

The ISO 8601 date and time after which the request for payment is no longer valid. After this time the debtor’s bank should no longer allow the debtor to pay it. Must not be before requested_execution_at.

requested_execution_at

string

Required

The ISO 8601 date and time by which you are requesting the payment to be made.

unstructured_remittance_information

string

Required

Unstructured information that will show on the recipient’s bank statement.

Between 1 and 140 characters,

Retrieve a Real-Time Payments Request for Payment

curl \
  --url "${INCREASE_URL}/real_time_payments_requests_for_payment/real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const realTimePaymentsRequestForPayment = await client.realTimePaymentsRequestsForPayment.retrieve(
  'real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7',
);

console.log(realTimePaymentsRequestForPayment.id);

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
real_time_payments_request_for_payment = client.real_time_payments_requests_for_payment.retrieve(
    "real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7",
)
print(real_time_payments_request_for_payment.id)

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

real_time_payments_request_for_payment = increase.real_time_payments_requests_for_payment.retrieve(
  "real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7"
)

puts(real_time_payments_request_for_payment)

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/Increase/increase-go"
	"github.com/Increase/increase-go/option"
)

func main() {
	client := increase.NewClient(
		option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
	)
	realTimePaymentsRequestForPayment, err := client.RealTimePaymentsRequestsForPayment.Get(context.TODO(), "real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", realTimePaymentsRequestForPayment.ID)
}

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestForPayment;
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentRetrieveParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

        RealTimePaymentsRequestForPayment realTimePaymentsRequestForPayment = client.realTimePaymentsRequestsForPayment().retrieve("real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7");
    }
}

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestForPayment
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentRetrieveParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

    val realTimePaymentsRequestForPayment: RealTimePaymentsRequestForPayment = client.realTimePaymentsRequestsForPayment().retrieve("real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7")
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $realTimePaymentsRequestForPayment = $client
    ->realTimePaymentsRequestsForPayment
    ->retrieve('real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7');

  var_dump($realTimePaymentsRequestForPayment);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using Increase.Api;
using Increase.Api.Models.RealTimePaymentsRequestsForPayment;

IncreaseClient client = new();

RealTimePaymentsRequestsForPaymentRetrieveParams parameters = new()
{
    RealTimePaymentsRequestForPaymentID = "real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7",
};

var realTimePaymentsRequestForPayment = await client.RealTimePaymentsRequestsForPayment.Retrieve(parameters);

Console.WriteLine(realTimePaymentsRequestForPayment);

Parameters

real_time_payments_request_for_payment_id

string

Required

The identifier of the Real-Time Payments Request for Payment.

More about Real-Time Payments Requests for Payment.

Cancel a Real-Time Payments Request for Payment

Cancels a Real-Time Payments Request for Payment that is still awaiting payment.

curl -X "POST" \
  --url "${INCREASE_URL}/real_time_payments_requests_for_payment/real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7/cancel" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{}'

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const realTimePaymentsRequestForPayment = await client.realTimePaymentsRequestsForPayment.cancel(
  'real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7',
);

console.log(realTimePaymentsRequestForPayment.id);

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
real_time_payments_request_for_payment = client.real_time_payments_requests_for_payment.cancel(
    real_time_payments_request_for_payment_id="real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7",
)
print(real_time_payments_request_for_payment.id)

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

real_time_payments_request_for_payment = increase.real_time_payments_requests_for_payment.cancel(
  "real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7"
)

puts(real_time_payments_request_for_payment)

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/Increase/increase-go"
	"github.com/Increase/increase-go/option"
)

func main() {
	client := increase.NewClient(
		option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
	)
	realTimePaymentsRequestForPayment, err := client.RealTimePaymentsRequestsForPayment.Cancel(
		context.TODO(),
		"real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7",
		increase.RealTimePaymentsRequestsForPaymentCancelParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", realTimePaymentsRequestForPayment.ID)
}

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestForPayment;
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentCancelParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

        RealTimePaymentsRequestForPayment realTimePaymentsRequestForPayment = client.realTimePaymentsRequestsForPayment().cancel("real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7");
    }
}

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestForPayment
import com.increase.api.models.realtimepaymentsrequestsforpayment.RealTimePaymentsRequestsForPaymentCancelParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

    val realTimePaymentsRequestForPayment: RealTimePaymentsRequestForPayment = client.realTimePaymentsRequestsForPayment().cancel("real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7")
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $realTimePaymentsRequestForPayment = $client
    ->realTimePaymentsRequestsForPayment
    ->cancel(
    'real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7',
    additionalInformation: 'x',
    reason: 'requested_by_customer',
  );

  var_dump($realTimePaymentsRequestForPayment);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using Increase.Api;
using Increase.Api.Models.RealTimePaymentsRequestsForPayment;

IncreaseClient client = new();

RealTimePaymentsRequestsForPaymentCancelParams parameters = new()
{
    RealTimePaymentsRequestForPaymentID = "real_time_payments_request_for_payment_28kcliz1oevcnqyn9qp7",
};

var realTimePaymentsRequestForPayment = await client.RealTimePaymentsRequestsForPayment.Cancel(parameters);

Console.WriteLine(realTimePaymentsRequestForPayment);

Parameters

real_time_payments_request_for_payment_id

string

Required

The identifier of the Real-Time Payments Request for Payment to cancel.

More about Real-Time Payments Requests for Payment.

additional_information

string

Additional information about the cancellation to pass on to the recipient bank.

Between 1 and 105 characters

reason

enum

The reason the request for payment is being canceled. Defaults to requested_by_customer.