Create Transfer | B2B - Gcashier Pay

{
  "merOrderNo": "335621309488901",
  "infoObject": {
    "feeDirection": "OUR",
    "tradeComments": "Service payment",
    "callbackUrl": "https://yourplatform.com/callback/transfer"
  },
  "senderObject": {
    "bizMode": "B",
    "bankCountry": "CN",
    "registerCountry": "CN",
    "companyName": "Acme Trading Co Ltd",
    "companyRegisterNo": "91110000123456789X",
    "companyIssueDate": "2015-03-01",
    "companyExpiryDate": "2035-03-01",
    "businessLicenseImg": "https://example.com/license.jpg",
    "addressCountry": "CN",
    "addressProvince": "110000",
    "addressCity": "Beijing",
    "addressLine": "No.88 Business Avenue"
  },
  "receiverObject": {
    "bizMode": "B",
    "payoutMethod": "WIRE",
    "accountNo": "987654321",
    "bankName": "JPMORGAN CHASE BANK",
    "swiftCode": "CHASUS33",
    "registerCountry": "US",
    "companyName": "Global Supply Inc",
    "companyRegisterNo": "US-12345678",
    "addressCountry": "US",
    "addressProvince": "New York",
    "addressCity": "New York",
    "addressLine": "500 Fifth Avenue"
  },
  "complianceObject": {
    "fundSource": "01",
    "purpose": "36"
  }
}

{
  "merOrderNo": "335621309488901",
  "senderAmount": {
    "currency": "CNY",
    "amount": "71250.00"
  },
  "receiverAmount": {
    "currency": "USD",
    "amount": "10000.00",
    "bankCountry": "US"
  },
  "infoObject": {
    "bizFlow": "21875022415083500100",
    "senderId": "b2c3d4e5f6a1",
    "receiverId": "a1b2c3d4e5f6",
    "settlementNetwork": "SWIFT",
    "rate": "7.1250",
    "status": "PROCESS",
    "code": "S00001",
    "message": "Processing"
  }
}

B2B (Business-to-Business): both sender (senderObject.bizMode = B) and receiver (receiverObject.bizMode = B) are enterprises. English company names and addresses must match the regex: ^[a-zA-Z0-9\s.,!?:;'"()\[\]{}/*\\-]+$

POST https://{baseUrl}/api/sp1307

Request Parameters

merOrderNo

string

required

Your unique merchant order number. Must be consistent with the value used in sp1306. Max 32 characters.

infoObject

object

required

Transfer settings and callback configuration.

Show infoObject fields

feeDirection

string

required

Fee arrangement. Required when settlementNetwork is SWIFT.

OUR — sender bears all fees.
SHA — each party bears their own bank fees.
BEN — receiver bears all fees.

tradeComments

string

Optional transfer remarks. Max 255 characters.

callbackUrl

string

required

Your HTTPS callback URL to receive the sp3302 webhook with the final transfer result. Max 255 characters.

senderObject

object

required

Enterprise sender’s company and address information.

Show senderObject fields

senderId

string

Pre-registered sender ID. If provided, skip all company fields below.

bizMode

string

required

Business mode. Must be B for enterprise.

bankCountry

string

required

ISO 3166-1 alpha-2 country code of the sender’s bank. Also used as the source-of-funds country.

registerCountry

string

required

Country where the company is registered.

companyName

string

required

Company name. Allowed characters: ^[a-zA-Z0-9\s.,!?:;'"()\[\]{}/*\\-]+$

companyRegisterNo

string

required

Company registration certificate number.

companyIssueDate

string

required

Certificate issue date. Format: YYYY-MM-DD.

companyExpiryDate

string

required

Certificate expiry date. Format: YYYY-MM-DD.

businessLicenseImg

string

Business license image. Required when bankCountry is CN.

registerCertImg

string

Business registration certificate image. Required when bankCountry is HK.

incorporateCertImg

string

Certificate of incorporation image. Required when bankCountry is non-CN. Also required when bankCountry is HK.

emailNo

string

Company email address (optional).

phoneAreaCode

string

Phone area code (optional). Must be provided together with phoneNo or both must be empty. See the phone code dictionary.

phoneNo

string

Phone number (optional). Must be provided together with phoneAreaCode or both must be empty.

addressCountry

string

required

Country of business address. See the country dictionary.

addressProvince

string

required

State or province. Use the English name for non-CN countries. Use the province/city code for CN. See the dictionary.

addressCity

string

required

City.

addressLine

string

required

Street address. Allowed characters: ^[a-zA-Z0-9\s.,!?:;'"()\[\]{}/*\\-]+$

postCode

string

Postal code (optional).

receiverObject

object

required

Enterprise receiver’s bank account and company information.

Show receiverObject fields

receiverId

string

Pre-registered receiver ID. If provided, skip all company fields below.

payoutMethod

string

required

Payment method. For SWIFT, the default is WIRE. For LOCAL, see the payment method data dictionary.

bizMode

string

required

Business mode. Must be B for enterprise.

accountNo

string

required

Bank account number.

bankCode

string

Bank code. Rules:

For LOCAL: required when payoutMethod is not WECHAT or ALIPAY. Also required when bankCountry is CN, BR, or IN (in which case branchCode is also required).
For SWIFT: not required (use bankName instead).

bankName

string

Bank name. Required for SWIFT transfers.

branchCode

string

Branch code. Required when bankCountry is CN, BR, or IN on LOCAL rails.

proxyBankName

string

Correspondent bank name. Optional, SWIFT only. Either provide all three proxy bank fields or none.

proxyBankAddress

string

Correspondent bank address. Optional, SWIFT only.

proxyBankSwiftCode

string

Correspondent bank SWIFT code. Optional, SWIFT only.

swiftCode

string

SWIFT/BIC code of the receiver’s bank. Required when settlementNetwork is SWIFT.

registerCountry

string

required

Country where the receiver’s company is registered.

companyName

string

required

Company name. For LOCAL transfers to CN in CNY, use the Chinese name; otherwise use the same format as the sender.

companyRegisterNo

string

required

Company registration certificate number.

businessLicenseImg

string

Business license image (optional). Applicable for CN.

registerCertImg

string

Business registration certificate image (optional). Applicable for HK.

incorporateCertImg

string

Certificate of incorporation image (optional). Applicable for non-CN and HK.

emailNo

string

Company email address (optional).

phoneAreaCode

string

Phone area code. Required when bankCountry is BR, KR, MA, or IN. See the phone code dictionary.

phoneNo

string

Phone number (optional).

addressCountry

string

required

Country of business address. See the country dictionary.

addressProvince

string

required

State or province. Use the English name for non-CN countries. Use the province/city code for CN. See the dictionary.

addressCity

string

required

City.

addressLine

string

required

Street address.

postCode

string

Postal code (optional).

complianceObject

object

required

Compliance and purpose information.

Show complianceObject fields

fundSource

string

required

Source of funds for the sender (enterprise). Use 01 (company funds).

purpose

string

required

Transfer purpose code. See the purpose data dictionary.

relationship

string

Relationship between sender and receiver (optional).

proofDocuments

array

Supporting transaction documents (optional). Maximum 5 items.

Response Body

merOrderNo

string

Echo of your merchant order number.

senderAmount

object

Sender amount and currency information.

Show senderAmount fields

currency

string

Sender’s currency code (ISO 4217).

amount

string

Sender’s amount. Two decimal places, format: 999999.99.

receiverAmount

object

Receiver amount, currency, and bank country information.

Show receiverAmount fields

currency

string

Receiver’s currency code (ISO 4217).

amount

string

Receiver’s amount. Two decimal places, format: 999999.99.

bankCountry

string

ISO 3166-1 alpha-2 country code of the receiver’s bank.

infoObject

object

Transfer status and reference information.

Show infoObject fields

bizFlow

string

System business flow number. Consistent with the value returned by sp1306. Retain this for reconciliation.

senderId

string

Sender’s registered ID. Present once the transfer is successfully confirmed.

receiverId

string

Receiver’s registered ID. Present once the transfer is successfully confirmed.

settlementNetwork

string

Settlement network used: LOCAL or SWIFT.

rate

string

Exchange rate applied to this transfer.

status

string

Current order status. Initial value is PROCESS (processing). The final result (SUCC or FAIL) is delivered asynchronously via the sp3302 webhook.

code

string

Transaction response code.

message

string

Transaction response message.

{
  "merOrderNo": "335621309488901",
  "infoObject": {
    "feeDirection": "OUR",
    "tradeComments": "Service payment",
    "callbackUrl": "https://yourplatform.com/callback/transfer"
  },
  "senderObject": {
    "bizMode": "B",
    "bankCountry": "CN",
    "registerCountry": "CN",
    "companyName": "Acme Trading Co Ltd",
    "companyRegisterNo": "91110000123456789X",
    "companyIssueDate": "2015-03-01",
    "companyExpiryDate": "2035-03-01",
    "businessLicenseImg": "https://example.com/license.jpg",
    "addressCountry": "CN",
    "addressProvince": "110000",
    "addressCity": "Beijing",
    "addressLine": "No.88 Business Avenue"
  },
  "receiverObject": {
    "bizMode": "B",
    "payoutMethod": "WIRE",
    "accountNo": "987654321",
    "bankName": "JPMORGAN CHASE BANK",
    "swiftCode": "CHASUS33",
    "registerCountry": "US",
    "companyName": "Global Supply Inc",
    "companyRegisterNo": "US-12345678",
    "addressCountry": "US",
    "addressProvince": "New York",
    "addressCity": "New York",
    "addressLine": "500 Fifth Avenue"
  },
  "complianceObject": {
    "fundSource": "01",
    "purpose": "36"
  }
}

{
  "merOrderNo": "335621309488901",
  "senderAmount": {
    "currency": "CNY",
    "amount": "71250.00"
  },
  "receiverAmount": {
    "currency": "USD",
    "amount": "10000.00",
    "bankCountry": "US"
  },
  "infoObject": {
    "bizFlow": "21875022415083500100",
    "senderId": "b2c3d4e5f6a1",
    "receiverId": "a1b2c3d4e5f6",
    "settlementNetwork": "SWIFT",
    "rate": "7.1250",
    "status": "PROCESS",
    "code": "S00001",
    "message": "Processing"
  }
}

Sandbox Testing

In the sandbox environment, the final transfer result is determined by the last digit of the submitted amount:

Last digit	Simulated result
0 – 3	Success (`SUCC`)
4 – 6	Rejected (`FAIL`)
7 – 9	No action (remains in `PROCESS`)

Payout Quote Create Transfer | B2C

⌘I

​Request Parameters

​Response Body

​Sandbox Testing

Request Parameters

Response Body

Sandbox Testing